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PREFACE 


MANUAL OBJECTIVES 

The information in this manual enables the new user of the RSX-11M 
operating system to create a text file, using an editing program, and to 
create and run a simple FORTRAN-IV program from that file. 


INTENDED AUDIENCE 
This manual is for the new RSX-11M user. It assumes that you have 
some computer experience, but no experience with RSX-11M. 


STRUCTURE OF THIS DOCUMENT 
This manual is structured so you can learn RSX-11M concepts and termi- 
nology as you create and run a FORTRAN-IV program called ADD.FTN. 


Chapter 1 explains how to use a terminal on the RSX-11M operating 
system. Chapter 2 discusses program preparation on RSX-11M, including 
use of an editing program, a compiler, and the Task Builder. Chapter 3 
outlines the RSX-11M method of handling files and records. Chapter 4 
discusses two system programs designed for handling files: PIP and the 
Queue Manager. Appendix A outlines the steps involved in the develop- 
ment of ADD.FTN, without the extensive explanation provided in earlier 
chapters. (For more detailed information on programming under 
RSX-11M, see the RSX-11M/M-PLUS Guide to Program Development. ) 


ASSOCIATED DOCUMENTS 

This manual refers frequently to other RSX-11M documents which are 
described in the RSX-/1M Documentation Directory. The directory 
defines the intended audience for the manuals in the RSX-11M set and 
provides a synopsis of each manual’s contents. 


CONVENTIONS USED IN THIS MANUAL 
“print” The term “print” indicates what the computer displays 
at the user’s terminal. 


“type” The term “‘type’” indicates what the user types at the 
terminal keyboard. 


Black ink In illustrations of dialogue between the user and the 
computer, what the computer prints is shown in black 
ink. 

Red ink In illustrations of dialogue between the user and the 


computer, what the user types is shown in red ink. 
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RUN 
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Square brackets enclose the optional parameters to a 
command. For example: 


>PRINT [/optional switches] 


However, the brackets are not part of the command. 
That is, if you want to use the optional COPIES 
switch with the print command above, you do not 
include the brackets in the command line. You simply 
type: 


SPRINT /COPTESs2 FOO.FUM 


A UED specification in a command line is always en- 
closed in brackets when you type it; that is, the brackets 
are required for the UFD syntax. 


Uppercase characters, in lines illustrating command 
formats, indicate material that you must type exactly 
as shown. 


Lowercase characters, in lines illustrating command for- 
mats, indicate variable parameters that you select. 


CHAPTER 1 
USING THE TERMINAL 


This chapter tells you how to use a terminal to communicate with the 
RSX-11M operating system. The operating system, in turn, communi- 
cates with the computer hardware. 


An operating system translates language you can understand into language 
the computer can understand. It also translates messages from the com- 
puter hardware to you. This two-way (interactive) communication pro- 
cess usually takes place through a terminal. 


You can use a variety of terminals with RSX-11M. These fall into two 
general categories: hardcopy terminals that print characters on con- 
tinuous forms of paper, and Cathode Ray Tube (CRT) terminals that 
display characters on a screen. Most CRT terminals do not provide per- 
manent records of the activity on your terminal. Figure 1-1 shows an 
LA36 hardcopy terminal. Figures 1-2 and 1-3 show the VT52 and the 
VT100 CRT terminals. 


Figure 1-1 An LA36 Terminal 
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1.1 USING THE TERMINAL KEYBOARD 

All terminal keyboards have the same basic layout as a typewriter. In 
addition, the keyboard includes special keys that affect various computer 
functions. These keys are not in the same position on all terminals; so 
check the keyboard layout each time you use a terminal that is new to 
you. Figure 1-4 is the keyboard of the LA36 and VT52 terminals. Figure 
1-5 illustrates the keyboard of the VT100 terminal. 
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Peels eget 1-4 LA36/VT52 Terminal Keyboard 
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Figure 1-5 VT100 Terminal Keyboard 


1.1.1 Terminal Function Keys 

Some of the function keys that appear on terminal keyboards are de- 
scribed in Table 1-1. Check the documentation for the system program 
you are using for specific information on that program’s use of terminal 
function keys. 


1.1.2 Control Characters 

You can enter a control character by pressing the appropriate letter while 
you hold down the CTRL key. The system responds to some control 
characters by displaying the up arrow (*) followed by the letter you 
typed (*U, for example). Some other control characters are not echoed 
on your terminal, depending on the function they perform. 


The control keys listed below are options selected at system generation. 
Therefore, if they do not work for you as described below, check with 
your system manager to see if they are part of your system. 
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Table 1-1 Special Terminal Keys 


CR or RETURN 


CTRL/n 


Terminates an input line and advances the 
carriage or cursor to the first position on the 
next line. 


Part of numerous 2-key combinations (CTRL 
and a letter key. When you press the CTRL 
key, followed by the appropriate letter, the 
combinations can perform a variety of func- 
tions. Each valid combination is called a 
control character, represented in this man- 
ual by n, where n is a variable letter (see 
Table 1-2). 


RUBOUT or DELETE | Deletes the last character typed on the cur- 
rent line and, if you press the key repeatedly, 
deletes contiguous characters to the left. 
Most CRT terminals remove each deleted 
character from the screen and move the print- 
ing position back one space. However, a 
hardcopy terminal prints a backslash (\), 
then each character as you delete it, then 
another backslash (\) before it prints the first 
correct character. For example: 


MISTKAE\EAK\AKE 


Advances the printing position to the next 
tab stop. Tab stops occur after every eighth 
character position in the line. In other words, 
the first tab stop is character (column) 9. 


These control keys will not always work as described here when you use 
them with various system programs. For example, some editing programs 
do not read CTRL/Z as an exit. Check the documentation for the system 
program you are using to determine its use of control Keys. 


Table 1-2 describes the most commonly used control characters. 
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Table 1-2. Terminal Control Characters 


Character 


CTRL/C 


CTRL/O 


CTRL/S and CTRL/Q 


CTRL/R 


Gains the attention of the Monitor Console 
Routine (MCR), which interprets commands 
to the operating system. In most cases, the 
system responds to CTRL/C by displaying 
the explicit MCR prompt: 


MCR> 


This prompt indicates that the system is ready 
to accept input from your terminal. 


Alternately suppresses and resumes the dis- 
play of output at your terminal. 


For example, if you are running a program 
that generates unwanted output, type 
CTRL/O. The system then temporarily stops 
displaying output until you type CTRL/O 
again to resume output display. (If you do 
not type another CTRL/O, the system will 
discard the entire output and then return the 
default MCR prompt (>) to let you know 
output is finished. 


CTRL/S stops the display of output at your 
terminal until you type CTRL/Q to resume it. 
For example, if you are using a CRT terminal 
that displays output too quickly for you to 
read, type CTRL/S to halt the display. When 
you have read what is on the screen, type 
CTRL/Q to restart the output display. Repeat 
the process until you have read the entire file. 


Performs a carriage return and reprints the 
current line on your terminal, omitting any 
deleted characters, and making the line easier 
to read. Before terminating the line with a 
carriage return, type CTRL/R to ensure that 
you have made the right corrections. For 
example: 


MISTKAE\EAK\AKE*R 
MISTAKE 
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Table 1-2 (Cont.) Terminal Control Characters 


CTRL/U Deletes the current line. This allows you to 
retype an entire line when individual correc- 
tions would be impractical. Remember that : 
CTRL/U must be typed before the carriage 
return in order to delete that line. After the 
carriage return is entered, you must use an o 
editing command from an editor to delete | ~ 
a line. 


CTRL/X Clears your terminal’s typeahead buffer and 


enables you to type additional characters. The 

typeahead buffer is an RSX-11M feature that mm, 
allows your terminal to save up to 36 charac- 
ters before it processes their commands. A 

““bell character’ echoes on your terminal no 

matter what character you type when this 

buffer is full, CTRL/X clears the buffer and 

enables you to resume typing. 


CTRL/Z Exits from many RSX-11M system (and user) 
tasks and returns control of the system to a~™. 
MCR. 


Note the difference between the CTRL/O-CTRL/O pair of commands and 
the CTRL/S-CTRL/Q commands: 


@ When you type CTRL/O after a previous CTRL/O, output dis- 
play resumes further down in the file than the point at which 
you halted it with the first CTRL/O. 

@ When you type CTRL/Q after a CTRL/S, output display begins 
where it stopped. The total output can still be displayed on 
your terminal. 


1.2 MCR COMMANDS 

The commands that interpret terminal input to control system operations : 
are called Monitor Console Routine (MCR) commands. You communicate 

with MCR by entering a command line in the following form: 


commandname parameter(s)/keyword(s) line terminator 
commandname 

Consists of three or more letters, terminated by a space, that uniquely 

identify an MCR function. MCR only reads the first three letters. 


Additional letters merely help you identify the command. (The only am 
exception to this 3-character rule is the HELP command. You must 
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type this entire command to distinguish it from the MCR HELLO 
command.) Some examples of MCR commands are given below: 


Command Function 
ABO[RT] Stops a running program 
DMO[UNT] Dismounts a volume 
UFD Creates a User File Directory 


parameter 


Specifies the object of the command function, which is usually a task 
or device. (A task is the basic executable program on an RSX-11M 
system.) One or more blank spaces must separate the parameter from 
the command name, or one parameter from another. For example, 
when you issue the ABORT command, you include the name of 
the running task to be aborted. The following command runs the 
task ADDTWO at 12:25:00 


RUN ADDTWO 12:25:00 
The following command aborts the task ADDTWO: 

ABO ADDTWO 

/keyword 

Modifies either the actual function of the command or a parameter 
of the command. When a keyword modifies a command function, 
you must insert a space between the command name and the key- 
word. For example: 

commandname /keyword [=value] 
When a keyword modifies a parameter of a command, the keyword 
immediately follows the parameter. In addition, some keywords are 
modified by an added numerical argument, shown in the examples as 
value. For example: 

parameter/key word [=value] 


Spaces are also not required between consecutive keywords: 


parameter/keyword/keyword. . . 
commandname /keyword/keyword. . . 


For example: 


SET /CRT=TI: 
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This command tells the RSX-11M system that your terminal is a 
CRT. TI: is a pseudo device name that stands for the terminal you 
are using, that is the terminal from which a command was entered. 
In this case, CRT is the keyword that determines the function of 
the SET command. 


line terminator 


Represents either the carriage return <CR©> or return key, or the 
altmode or escape key (<ESC>). Because <ESC> has a special 
meaning under certain circumstances, this manual uses <CR> as a 
terminator. Any terminator causes the line to be sent to the com- 
puter or to the task waiting for input. 


Before typing a command, you must ensure that the terminal is in the 
right state to accept commands by: 


® Checking that the terminal’s power is on 

@e Checking that the LOCAL/REMOTE switch is set to REMOTE 

e Consulting installation instructions for additional required 
terminal settings or instructions for using a dial-up line 

e Typing CTRL/C to obtain the explicit MCR prompt (MCR>). 


Both the explicit MCR prompt and the default prompt (>) indicate that 
MCR is ready to accept input from your terminal. If you enter CTRL/C 
when you are using a system program other than MCR, you can issue one 
MCR command. The system executes that command and returns you to 
the task you were in when you entered CTRL/C. Both DIGITAL-supplied 
and user-written tasks can request input by displaying a task prompt at 
a terminal. 


NOTE 
If you are working with a system that does not 
support multiuser protection, you do not need 
to log on and off the terminal. Terminals con- 
nected to a nonmultiuser system are available 
to any user. Therefore, you can ignore the 
material in the remainder of this chapter. 


1.2.1 The HELP Command 

HELP is the only command (besides HELLO, the logging-on command) 
that you can issue from a terminal before you log on the system. Because 
the first three letters of HELP are the same as HELLO; you must enter the 
HELP command in full. When you issue this command, your terminal dis- 
plays text (determined by each installation) that tells you how to log on 
and how to issue further commands. Even if you do not need help initially, 
issue the command at least once so that you know the nature of the infor- 
mation available to you from the system. 
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1.2.2 The HELLO Command 
To begin a session at the terminal, you must issue the MCR HELLO com- 
mand to log on. 


Logging on the system accomplishes several things: 


@e  =It allows the system to make sure that you are an authorized 
user and to record information about your use of the system 

@ It grants you the use of the terminal for access to the system 
until you log off 

@ It establishes initial default values for your terminal activities 


The MCR HELLO command prompts for its parameters as follows: 


“HELCLOUSCK 
ACCOUNT OR NAME? [sty mde CRS 
ar 
Lagst-namenCk 
FASSWORT: rasswordcClke 


[gm] 


Commonly called a UIC and consists of two octal numbers that 
identify your account on the system. The first number (g) stands 
for your user group; the second number (m) is your member number 
within the group. The general UIC format consists of the two num- 
bers separated by a comma and enclosed in square brackets [g,m]. 
When you receive your UIC on a multiuser protection system, a 
User File Directory (UFD) with the same number is created for 
you. 


Although you have access to other UFDs on the system, your UIC 
remains the same, no matter which UFD you are working with. 


last-name 


Your last name, which you can enter instead of a UIC. The system 
determines your correct UIC from the name you specify. 


password 


A 1- to 6-character alphanumeric string. The system maintains 
account information, including correct passwords for each UIC and 
last name. You cannot gain access to the system unless you type the 
password corresponding to the UIC or name you have entered. 


The system does not print (echo) on your terminal the characters 
you type in response to the PASSWORD prompt. This ensures that 
your password remains private and that no one can log on using your 
account. 
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If you do not know your UIC or password, contact the system manager or 
whoever controls the use of your system. 


An example of the log-on procedure follows: 


SHELA CK 
ACCOUNT OR NAME SCONRAIS CR 
PASSWORT ¢ OR 


RSX LLM BLS MULTIUSER SYSTEM 


GOOD AFTERNOON 
L2-JAN@ 79 41807 LOGGEN ON TERMINAL TTS2 ¢ 


1LO- JAN 79 


SYSTEM WILL BE DOWN TODAY FROM 13200 TO 
15300 FOR CORRECTIVE MAINTENANCE 


When the system receives the correct password the terminal displays a 
message that includes system identification and the date and time you 
logged on the terminal. Notice the password is not echoed in the example 
above; this is the way your terminal will look when you enter your 
password, The terminal can display additional messages, which usually 
supply information that affects general use of the system. The default . 
MCR prompt (>) on the line after the messages indicates that the mes- 
sages are complete and MCR is ready to accept commands. 


If the following message appears when you try to log on, someone else is 
using the terminal: 


os OTHER USER LOGGED ON 


Either try to log on a different terminal or find the person who logged on 
before you. Do not use the terminal without the other user’s knowledge. 


The Quickest Ways to Log On 

Most users want to type as little as possible when using a terminal; they 
also want the quickest possible response time. This section describes ways 
to shorten the log-on procedure. 


Suppressing System Messages 

The HELLO command allows you to enter a special form of the UIC 
parameter to suppress the display of most of the system messages. (The 
system message file text can be written so that important messages cannot 


Using the Terminal 


be suppressed.) The normal format for a UIC is [gsm]. However, if you do 
not want to see the system messages, replace the comma with a slash (/) 
as follows: 


[g/m] 


HELLO allows four UIC formats: 


g/m 
[g/m] 
gm 
[g,m] 


Either of the slash formats suppresses all but the most important of the 
system messages. When you log on, brackets around the UIC are optional. 
However, a UIC must always be specified in the format [g,m] when it is 
a parameter of any other command. 


Suppressing ACCOUNT OR NAME Prompt 

Another way to shorten the time required to log on is to enter the 
HELLO command and UIC (or last name) on the same line using a slash 
character as a separator: 


Ke 


“HEL, 2OL/312¢C0Re 
PASSWORT § “CF 


This command format suppresses the prompt for ACCOUNT OR NAME. 


Automatic Execution of Log-On Command File 

After you log on a terminal, the system automatically assigns the name 
SY: to your system disk and then searches your UFD on SY: for the file 
LOGIN.CMD. If found, the system sends LOGIN.CMD to the indirect 
command processor, which executes all of the commands in LOGIN.CMD. 


This feature is useful when there are specific commands you issue each 
time you log on the system. 


For example, you could use your login command to set your terminal to 
be a CRT and to accept lower case letters. You could also include in the 
file a command to print a text file containing messages to yourself (just 
as the system prints a text file containing messages to all users when you 
log on), When you want to change the messages to yourself, you simply 
edit the text file MYLOGIN.TXT below. In this case, the following 
message is displayed on your terminal after the system messages: 
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* @LOGIN. CMD 

“SET /LOWER=TT $ 
“SET /CRT#=TIL 

SPIF TLe=MYLOG. TXT 


10300 MEETING WITH MANAGERS 
11300 RACQUETBALL WITH JACI 
12330 FINANCE COMMITTEE MEETING 
“RL EOF = 


1.3 ERROR MESSAGES 

When MCR receives input that it does not recognize or that it knows to be 
incorrect, it displays a message on your terminal. An example is the mes- 
sage that appears if you try to log on a terminal already in use. You will 
receive a different message from MCR if you enter a UIC (or last name) 
or password that the system does not recognize: 


HEL ACR 
ACCOUNT: OR NAME? CONRAKE CR 
FAS SWORD s on as 


HEL. INVAL TO ACCOUNT 


This attempt to log on was not successful, either because the system did 
not recognize the last name (CONRAK), or because you did not enter 
the correct password. 


The appropriate user response to an error condition depends on the 
message displayed. All messages returned by MCR commands are ex- 
plained in the RSX-11M/M-PLUS MCR Operations Manual. Command 
descriptions in that manual include a list of possible messages that the 
command can generate. The manual also includes an alphabetical list of 
all MCR messages. 


Each message a task prints on your terminal begins with the 3-letter name 
of the associated command or task sending you the message. When you 
encounter an error while running a system task, such as a text editor, 
look for an explanation of the message in the documentation for that 
task. 


CHAPTER 2 
PROGRAM PREPARATION 


Four steps are required to prepare a program to run on RSX-11M: 


1. Create a source file 
Compile or assemble the source file to produce an object 
module 

3. Link the object module to create a task image file 

4. Run the task (using an MCR RUN command) 


Each of the steps involves the manipulation of at least one file, which is 
an owner-named and created area on a mass storage volume (usually a 
disk or tape). 


When you log on a terminal, the system automatically allows you access 
to a disk. This disk is your default system disk on which RSX-11M stores 
all your files unless you specify otherwise. (If your system does not have 
multiuser protection, you have automatic access to a system disk that is 
also accessible to all users.) This chapter assumes you are using your 
default system disk. 


Note that the RSX-11M operating system lets you run programs written 
in a number of computer languages. The MACRO-11 assembly language is 
always included with RSX-11M. Check with your system manager to see 
what other languages are available to you. 


Each language has its own system program (called an assembler or com- 
piler, depending on the language). This system program translates a source 
program into an object module and makes sure that the source program 
follows the language syntax rules. 


Each language compiler or assembler can only translate source files 
written for that language: the FORTRAN-IV program in this book must 
be compiled by a FORTRAN-IV compiler (see specific language documen- 
tation for more information.) 


Although this manual illustrates the creation of a FORTRAN-IV program, 
you follow the same steps to create a MACRO program, a COBOL pro- 
gram, or a program in any other compiled or assembled language. The 
only difference is in the language translator you use. 


2.1 CREATING THE SOURCE FILE (EDI) 

The RSX-11M Line Text Editor (EDI) is a system program you can use to 
create a source file. (You can also use EDI to create other types of files, 
such as text files and data files.) RSX-11M includes two other editing pro- 
grams: the DEC Standard Editor (EDT) and the Source Language Input 
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Program (SLP). EDT is especially useful with a CRT terminal because it 
lets you edit by character as well as by line. SLP is used primarily to 
maintain system programs. (See the RSX-11 Utilities Manual for docu- 
mentation of EDT and SLP, as well as additional information about EDI.) 


This chapter uses a limited number of EDI commands to show you how to 
create and edit the source file for ADD.FIN. 


2.1.1 Using EDI to Create a Source File 
To invoke EDI, issue a call to the editor in the same way that you issue 
an MCR command. (Remember you can always type CTRL/C to get the 
explicit monitor prompt and make sure your command is going to MCR.) 
* EDLACR> 
EDI displays its task prompt: 
ETT > 


To create a new file using EDI, specify a file name and a file type in the 
following form: 


EQI>filename.filetyre 
filename 
A 1- to 9-character alphanumeric string. 
filetype 
A 3-letter abbreviation, preceded by a period (.). The abbreviation is 


usually related to the file’s contents. The following are standard file 
types for programming language source files: 


Type Language 

.BAS BASIC 

.CBL COBOL 

.FTN FORTRAN 

.F4P FORTRAN-IV-PLUS 
MAC MACRO 


The following example, which is used throughout this chapter, illustrates 
the creation of a FORTRAN IV source file called ADD.FTN. ADD.FTN 
is an interactive program that prompts you to type two numbers at a 
terminal. The program then adds the two numbers and prints the result on 
your terminal. 
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ELIT CR 

2 EDT AN. FTN CR 
CCREATING NEW FUME 
INF UT 


When EDI receives the name of a new file, it creates an empty file 
with that name and type and displays the two lines shown in the example 
above. EDI prints INPUT to let you know it is ready to accept input from 
your terminal. Anything you type except for control characters becomes 
part of the file called ADD.FTN. You can then type in the source program 
for ADD.FTN. When you terminate each line of input with a carriage 
return <CR>, EDI stores the line in a buffer. When you end the editing 
session, EDI writes the entire buffer to the file ADD.FTN. 


You can use the keyboard facilities described in Section 1.1 to correct 
any mistakes on the current line before you type <CR>. Once a line has 
been terminated and written to the buffer, you must use EDI commands 
to make any changes. 


You can also enter the new file name and file type on the same line as 
the call to EDI. This quicker way to create a file is illustrated below. Note 
the use of the DELETE or RUBOUT key, CTRL/R, and CTRL/U in the 
example: 


SZ EDT AND. PTNECK 

CCREATING NEW FILES 

TINFUT 
TYPE LaCk > 

d FORMAT ¢% ENTER TWO NUMBERS ~- MeN aCR> 
APPENEFPPANCCERPT 2ykKy LOR 
ACCEPT Sy Ky LaCk> 


2 FORMAT (222\22\15) CR 
FRINTCU 
TYPE Sy KtL SCR 

3 FORMAT (/ THE SUM IS TS) <CR» 
STOPECR 
ENDSCR: 

<CRe 

x EX<CR 


DEXITA 


After you terminate the last line of text in the program, type a carriage 
return as the first character in the new line. EDI responds by displaying 
an asterisk (*) prompt. Until now, EDI was in Input Mode, the mode it 
entered to create a new file. Typing a carriage return (<CR>) at the 
beginning of a new line switches EDI to Edit Mode. The asterisk is EDI’s 
prompt for commands. 
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The command EX[IT] instructs EDI to write ADD.FTN to your disk area 
and to return control of your terminal to MCR. 


The KILL command closes both input and output files and deletes the 
output file. It eliminates all traces of the current editing session. 


2.1.2 Editing an Existing File 
To edit an existing file with EDI, enter the same command you used to 
create a new file: 


SELL ADD. FTNECK: 


Because a copy of ADD.FTN now exists on disk, EDI responds differ- 
ently, as follows: 


SET AQ. FTNECRS 
ROO008 LINES REA TNA 
CRAGE 12 

x 


EDI creates a copy of ADD.FTN and enters Edit Mode, indicated by the 
asterisk (*) prompt. The message [00008 LINES READ IN] tells you the 
number of lines EDI has placed in its buffer. The lines in the buffer make 
up the text currently available for editing. The buffer may or may not 
contain the entire input file, depending on the size of the file and the 
buffer. To access text beyond the current buffer, issue a RENEW com- 
mand in Edit Mode. Renew writes the current buffer to the output file 
and refills the buffer with the next block of text. 


An internal line pointer determines the line within the buffer to be edited. 
When EDI reads in a buffer, the line pointer points to the line immedi- 
ately preceding the first line of text. This allows you to insert one or more 
lines at the top. You can subsequently reposition the pointer by searching 
for a particular piece of text or by using commands that reposition the 
pointer. 


Locating and Changing Text 

The EDI commands listed below allow you to find and change text in a 
file. You can abbreviate most EDI commands to one or two letters. In 
the following text, the optional portion of each command is in square 
brackets []. 
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Command Function 
L[OCATE] Locates a string of text in the current buffer 
C[LHANGE] Replaces one text string with another 
N[EXT] Advances the line pointer to the next line (EDI 


displays the Edit Mode prompt (*) but does not 
display the line) 


P[RINT] Displays the current line on your terminal 

T[OP] Positions the line pointer at the top of the current 
buffer 

BO[TTOM] Positions the line pointer at the bottom of the 


current buffer 


<CR> Points to and displays on your terminal the next 
line in a file 


An example of an EDI editing session is shown below with text explaining 
what each command does to change or to locate lines in the file and print 


them on the terminal. 


EDT ADI. PTNACR 


ROO008 LINES REA IN 

CPAGE 13 

XLOCATE ENTERA CR 

il FORMAT (7 ENTER TWO NUMBERS - MeN7) 
x 


The LOCATE command in the example above points to and prints the 
next line in the file (after the current line) containing the word ENTER.) 


XCHANGE /ENTERS TYRE Z ECR 
I FORMAT ¢€¢ TYRE TWO NUMBERS - MyN%) 
x 


The CHANGE command above changes the word ENTER to TYPE. Note 
that the slash characters (/) are used to delimit both the old and the new 
text strings. Any ASCII characters that are not used in either string can be 
used to delimit a string. EDI then prints the corrected line on your 
terminal. 


*X NEXT CRC 
x 
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The NEXT command points to the next line in the text, but does not 
print it on your terminal. 


KPRINTACR> 
ACCEPT 2a Kyl. 
x 


The PRINT command above displays the current line on your terminal. 


KLOCATE SUM<CR> 
2 FORMAT (/ THE SUM IS ‘9 TS) 
* 


The LOCATE command points to and prints the next line in the file con- 
taining the word SUM. 


* CHANGE /SUM/RESULT/<0CRS 
3 FORMATC’ THE RESULT IS “»T%) 
* 


The CHANGE command above changes the word SUM to RESULT. 


KLOCATE C205 2Ck> 
CXEORXKI 


The LOCATE command searches for a line containing (215). In this case, 
EDI reaches the end of the buffer (EOB) without finding the string (215). 
The EDI line pointer only moves forward through the buffer in response 
to a LOCATE command. It does not search backward through a file. 


¥ TOP ACK 
x 


The TOP command moves the line pointer to the top of the buffer (one 
line before the first line of text). At that point, Edit Mode displays the 
asterisk prompt (*). 


KCK 
TYPE 1 
x 


When you enter a carriage return in response to the asterisk prompt EDI 
prints the next line on your terminal. The carriage return also moves the 
EDI line pointer to the next line. Therefore, it performs the same func- 
tion as the NEXT and PRINT commands. In this example the pointer 
points to the first line in the buffer. 
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K EXD TACKS 
PEXIT 


The EXIT command writes the current buffer and the remainder of the 
input file to the output file, closes both input and output files, and exits 
from EDI to MCR. 


Inserting and Deleting Text 
The EDI commands listed below allow you to insert and delete text in 
the file. 


Command Function 

I{NSERT] Inserts one or more new lines of text in a file. 
A[DD] Adds text to an existing line. 

D[ELETE] Deletes the current line. 

<ESC> Points to and prints the previous line. Note, how- 


ever, that <ESC> does not display the line you 
just entered with an Insert command. It moves 
the pointer up one line in the text and displays 


that line. 
R{LETYPE] Replaces the current line of text with a new line. 
LI[ST] Prints on your terminal the lines remaining in the 


buffer, from the current line to the end. After the 
LIST command executes, the line pointer is reset 
to the top of the buffer. 


TYPE n Prints on your terminal the next n lines, but does 
not reset the line pointer. 


An example of an EDI editing session is shown below with text explaining 
what each command does to insert or delete text. 


“EDT ATIF THC 
POOOO8 LINES REAL ING 

RRAGE 10) 

* 

EDI retrieves the latest version of ADD.FTN. Note that if you want to 


edit an earlier version of ADD.FTN, you can include a version number in 
this command. 
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*INSERTACRe 


C THIS FROGRAM ADDIS TWO NUMBERS<CR 
CRE 

XK ESC? 

CxKRORKI 

a Oe 

C THIS PROGRAM ALIS TWO NUMBERS 

x 


The EDI INSERT command in the text above switches to EDI Input 
Mode and inserts text immediately before the first line of text already in 
the buffer. The second carriage return takes you back to Edit Mode. The 
<ESC> command from Edit Mode causes EDI to display the line before 
the current line. In this case, the line before the current line is the begin- 
ning of the buffer [*BOB*]. The carriage return moves the pointer to the 
line you just inserted, which is now the first line of the text. 


XLOCATE NUMBERS<CR: 

1 FORMAT (7 TYPE TWO NUMBERS ~ MyN4) 
Xan IF ROMET FOR INFUT CORD 

TPRINT« “CRD 


x 


The LOCATE command finds the line on which a string occurs, the ADD 
(append) command attaches a comment text to the line, and the PRINT 
command displays the revised line. 


¥_OCATE RESULT "CR: 
3 EORMAT €° THE RESULT IS “+25) 


WOELETESCR™ 


The DELETE command deletes the current line and moves the pointer to 
the next line. 


KeESC> 
TYFE Sy W+L. 
* 


The <ESC> command causes EDI to point to and print the previous line 
in the buffer on your terminal. 


XINSERTECRE 
3 FORMAT (¢ THE SUM IS ‘9 TS) I0ISFLAY RESULT<C 
ZCR® 


FORMAT ¢(¢% TYPE TWO NUMBERS ~- MyN?7> PP ROME 


T FOR 


INE UT 


Re 
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EDI enters insert mode and inserts a new line of text. The second carriage 
return causes EDI to reenter Edit Mode at the current line. 


* TOPIC: 

*<ORE 

C THIS PROGRAM ADNS TWO NUMBERS 

KRETYPE C AND DISELAYS THE SUM OF TWO NUMBERS <CR: 


* 


The TOP command repositions the line pointer to the top of the buffer. 
The carriage return points to and prints the next line, which in this case is 
the first line in the buffer. The RETYPE command replaces the current 
line with the text that follows the command. 


KLISTHACK> 


C ANN DISPLAYS THE SUM OF TWO NUMBERS 
TYPE 1 
1 FORMAT ¢7 TYPE TWO NUMBERS - MyN%) PPROMP 


ACCEPT 2yKyel. 
a FORMAT (20%) 
TYPE Ser. 


3 FORMAT ¢€¢° THE SUM IS ‘sTSOINTSPLAY RESUL’ 
STOF 
ENT 

x 


The LIST command displays the lines from the current line to the end of 
the buffer. 


x EXICRS 


When you issue the EXIT command, EDI writes the file to your disk area 
and returns control to MCR. 


2.1.3 Basic EDI Commands 
Table 2-1 summarizes the basic set of EDI commands. These commands 
provide all the functions you need for simple editing. 
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Table 2-1 Basic EDI Commands 


A[DD] string Appends string to the current line. 


BO[TTOM] Moves the line pointer to the bottom 
of the current buffer. 
C[HANGE] /string1/string2/ Replaces string! with string2 in the 


current line. 
<CR> 


CTRL/Z 


D[ELETE] 
<ESC> 


EX{IT] 


When in Input Mode, <CR> returns 
you to edit mode. 


When in Edit Mode, <CR> prints 
the next line on your terminal and 
moves the line pointer to that line. 


Closes the input and output files and 
terminates the editing session. 


Deletes the current line. 


Points to and prints the previous line. 


Closes the input and output files and 
terminates the editing session. 


I[NSERT] string 


KILL 


L[OCATE] string 


Inserts string before the next line or 
enters input mode if string is omitted. 


Closes both input and output files 
and deletes the output file. 


Locates the next line containing the 
object string. The search stops at the 
end of the current buffer. 


N(EXT] Advances the line pointer to the next 
line. 


P[RINT] 


Prints the current line on your 
terminal. 


REN[EW] Writes the current buffer to the out- 
put file and reads in another buffer 


from the input file. 
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Table 2-1 (Cont.) Basic EDI Commands 


Replaces the current line with the 
object string. 


Command 


R[ETYPE] string 


T[OP] Moves the line pointer to the top of 


the buffer. 


TYPE Prints on your terminal the next 
n lines but does not reset the line 
pointer. 


2.2 COMPILING A FORTRAN-IV SOURCE FILE 

After you have created a FORTRAN-IV source file, in this case ADD.FTN, 
the next step is to compile the program into machine-readable (binary) 
form. This compiled program is called an object module. 


2.2.1 Creating an Object Module 
You begin the compilation process by issuing a call to the FORTRAN-IV 
compiler (in the same way you issued a call to the editor, EDI): 


“FOR ATM. OBJ“AIN.FTNECRS 


This command line tells the FORTRAN-IV compiler to compile the 
source file ADD.FTN to produce an object module called ADD.OBJ. As 
the example shows, you specify from left to right the output file (ADD.- 
OBJ), an equal sign (=), and the input file (ADD.FTN). 


NOTE 
RSX-11M command line specifications follow 
the convention used by many computer lan- 
guages: the output of a process appears to the 
left of the equal (=) sign and the input to the 
process appears to the right. (See Chapter 3 for 
more information on file specifications.) 


The FORTRAN-IV compiler defaults the object file type to .OBJ and the 
source file type to .FTN. This means that if you do not include a file type 
with the file name in a command to the compiler, FORTRAN searches for 
a file with the name you supply and a file type of .FTN. If it finds one, it 
uses that file as input. FORTRAN creates a file with a type of .OBJ as 
output if you do not specify an output file type. 


Program Preparation 


Most RSX-11M system programs and all language processors use defaults 
in this way. For this reason, you should use the standard file types when- 
ever possible. (Additional standard file types are described in the RSX- 
11M/M-PLUS MCR Operations Manual and are listed in the RSX-11M 
Mini Reference.) 


The default file types in the FORTRAN-IV command line are shown in 
Table 2-2. 


Table 2-2 Default FORTRAN-IV Compiler File Types 


| 


Using the defaults, you can shorten the above command to: 


Default File Type 


Listing File 
Object Module 


“FOR AD ADICRS 


By appending switches to the input and/or output file specifications, you 
can make special compilation requests. (See the JAS/RSX-1] FORTRAN 
IV User’s Guide for a description of the FORTRAN-IV compiler 
switches.) All of the examples in this section assume you are using the 
compiler defaults. 


2.2.2 Creating a Listing File 

In addition to translating a source program to an object module, the 
FORTRAN-IV compiler can also supply a listing file and a storage map for 
the program. To create a listing file you enter the command: 


“FOR Aly AITEAITIC CR 


The second ADD on the output side of the command instructs the com- 
piler to produce a listing file and storage map (called ADD.LST) for the 
source program. The listing file provides information on compiler errors 
and the storage map lists the symbolic names used in the program and 
flags references to symbols that will have to be resolved by the Task 
Builder. 


If the system includes the Queue Manager and spooling to a line printer, 
the FORTRAN-IV compiler automatically puts ADD.LST in the line 
printer queue. You can inhibit this automatic printing with the following 
command line: 


“FOR ANNs ANN/-SFeAINL CK 
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The -SP switch tells the compiler not to spool the listing. 

The compiler also stores a copy of ADD.LST on your system disk. (If 
your system does not include spooling, the compiler only stores the file 
on disk.) 

The FORTRAN compiler can also produce a listing file of your program 
without creating an object file. This feature enables you to find errors in 
your program using the listing file, without generating multiple versions 


of unusable object files. To produce only a listing file, enter a command 
in the following form: 


a FOR y ATE ATT Ck 
Following this command, ADD.LST is both spooled to the line printer on 
systems with spooling and also stored on your disk area. 
Note that you must enter a comma before the listing file specification in 
the command line; otherwise the compiler interprets ADD as an object 


module instead of a listing file. 


The following command causes a copy of ADD.LST to be displayed at 
your terminal but not printed on the line printer or saved on disk: 


SFOR AN TL 2 eAnn CR 


2.2.3 Requesting a Nonresident FORTRAN-IV Compiler 
In some cases, you may issue the FOR command and receive the message: 


MGR TASK NOY IN SYSTEM 


This means that the FORTRAN compiler is not currently installed on 
your system. To install the compiler, issue the MCR command: 


“RUN $FOR SCR 
This command tells the system to install the FORTRAN compiler in 
memory and to activate it at your terminal. The compiler responds with 
the prompt: 

FOR 


You then enter the FORTRAN-IV command as illustrated previously: 


FORD Ay ALIEALUE CR 
PORE oz 
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After the compiler executes your commands, it displays the task prompt man. 
(FOR>) once again. At this point, you can compile additional FORTRAN : 
programs or exit from the compiler. Enter CTRL/Z to terminate the com- 

piler and remove it from memory. (See the RSX-11M/M-PLUS MCR 

Operations Manual for details on the RUN command.) 


2.3 BUILDING A TASK IMAGE 

The RSX-11M Task Builder converts the object modules created by a ; 
language translator into a single task image file. This task image file 

resides on disk until someone issues an MCR command to install and run 

it. (You may have used computer systems which referred to some parts of : 
the Task Building process as linking or loading.) 


2.3.1 Full Task Build Command Line 


A full Task Builder command line uses three output files and any number 
of input files. The output files are: 


1. The task image file (filename.TSK) which contains the task 
image to be installed and run 

2. A memory allocation file (filename.MAP) which contains infor- 
mation about the size and location of various parts of the task 

3. A symbol definition file (filename.STB) which contains infor- 
mation about the task’s global symbol definitions (The STB 
file is not needed or created in most Task Builder operations.) 


The input files include all of the object modules and modules from system 
or user libraries required to produce a single task image. The full Task 
Builder command line is: 


>TKB task image file, map file, symbol definition file=object file(s) 


Table 2-3 illustrates the default file types in the Task Builder command 
line. 


Table 2-3 Default Task Builder File Types 


Default File Types 


Object File 


Task Image File : 
Task Builder Map 
Symbol Definition 
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To Task Build ADD.FTN, issue the following command: 


“TKE ADD. TSKeADD. MAP YAIN. STB=ANT.OBJsL BI CLs LIFOROTS/L BACKS 


In this command, LB: is a pseudo device name for the device containing 
the library, [1,1] is the UFD where the library is stored, and FOROTS 
is the FORTRAN Object Time System library. The RSX-11M/M-PLUS 
Task Builder Manual describes the use of the LB switch to include OTS 
libraries in task image files. 


Using Task Builder defaults, the command can be shortened to: 
“TKE ALD ADMANINHAMM ey L BIC Ly LIFOROTS/L BACKS 


2.3.2 Short Task Build Command Lines 

Like the compiler, the Task Builder allows you to omit any output file 
or to direct output files to your terminal or to a line printer. However, 
if you omit an output file in the beginning or middle of the output side of 
a file specification, you must retain the comma in place of the file name 
to specify a null (empty) field. On the input side of the command, use a 
comma to separate one input file from another. Table 2-4 illustrates the 
creation of Task Builder output files. 


Table 2-4 Task Builder Output Files 


Command Line Output Files Generated 
>TKB .TSK,.MAP,.STB=.OBJ All three output files 


>TKB ,,.STB=.OBJ Symbol definition file only 


>TKB ,.MAP,.STB=.OBJ Memory allocation and symbol 
definition files 


>TKB .TSK,,.STB=.OBJ Task image and symbol defini- 
tion file 


>TKB .TSK,.MAP=.OBJ Task image and memory alloca- 
tion files 


>TKB .TSK=.OBJ Task image file only 


2.3.3 Multiline Task Build Command Procedures 

A long list of input files can cause a Task Builder command line to exceed 
the terminal’s maximum line length. If this happens, you can invoke the 
Task Builder in the following manner: 


“ TRESCRS 
TREC 
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After you enter the carriage return, MCR activates the Task Builder, 
which then returns the TKB> prompt. The Task Builder displays its 
prompt after each line of input until you enter two slash characters (//) 
and a carriage return at the beginning of a line. The slash characters ter- 
minate operation of the Task Builder and return you to MCR. For 
example, the single command line: 


* TKR 
TKE? filmam. TSWsfilnam. MARY fi lnam.STR=f i Liam OBJ y OBJ 7 OBIZCR? 


can be entered as: 


TKES filnam. TSKyfilnam MAP sy filnam. STR=filnamd) OBJCKS 
TRE? filnam2 OBJ ftilnams OBJECRS 
TRE? //20R> 


2.3.4 Listing the Memory Allocation (MAP) File 

The memory allocation file (map file) is an ASCII file that contains infor- 
mation about the size and location of components within the task. If your 
system includes the queue manager and print spooling options, the Task 
Builder spools the file to the line printer by default. 


Without the spooling option, however, the Task Builder only stores the 
file on your system disk. 


2.3.5 Task Builder Switches and Options 

The Task Builder includes a variety of switches and options to control the 
creation of a task image on disk. These switches and options are described 
in detail in the RSX-11M/M-PLUS Task Builder Manual. 


2.4 RUNNING A TASK 
To run the task you created, issue an MCR RUN command as follows: ~ 


“RUN ATW ACR 
The RUN command instructs the system to: 
@ Locate ADD.TSK on your default system disk 


@ Load a copy of the task image into memory 
e Execute the task 
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When you use this form of the RUN command, the task image file remains 
on disk, ready to be run again, until it is explicitly deleted. 


The following sections illustrate three successful executions of the 
FORTRAN-IV program ADD.TSK. Remember that ADD is an interactive 
program; that is, it prints a message on your terminal and then waits for 
you to type in a response before it performs the calculations and prints 
the result on your terminal. 


SRUN ALD CR 
TYFE TWO NUMBERS ~ MyN 
Jy BLOKE 

THE SUM IS 10 

TT47 ~~ STOP 


PRUN ATID CR 

TYPE TWO NUMBERS ~ MyN 
5229 62BSCR 

THE SUM IS 1150 

TT47 =~ STOF 


“RUN ATI Cr 

TYPE TWO NUMBERS - MyN 
Py LSLCRS 

THE SUM TS 25 

TT47 «-- STOF 


Note that when the program completes execution, it displays the line: 
TTA? STOr 


TT47 is a temporary name assigned to the task when you issue the RUN 
command. The version of the RUN command used in this example causes 
the system to name the task TTn, where n is the unit number of the ter- 
minal running the program. 


Figure 2-1 reviews the steps to creating the FORTRAN-IV task ADD, 
including the specific files created in each step. 
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>EDI 
EDITOR 


SOURCE 
PROGRAM 


>FOR 


COMPILER 
OBJECT 
MODULE 


>TKB 
TASK 
BUILDER 


TASK IMAGE 


>RUN 


: TeTRES 
SYSTEM S 


LIBRARIES 


TASK BUILDER 
MAP 


SYMBOL 
DEFINITION 
FILE 


EXECUTING 
TASK 


Figure 2-1 Development of a FORTRAN-IV Task 


CHAPTER 3 
THE FILES 


The RSX-11M file specification is used by all RSX-11M system programs, 
including editors, compilers, utilities, and the Task Builder. 


The examples in Chapters | and 2 emphasized using defaults in command 
line file specifications. Defaults are useful because they allow you to use 
the resources of the system without understanding every possible choice 
available to you. They also permit you to do less typing. In many situa- 
tions, however, you will need a complete file specification, because de- 
faults alone will not cause the system to do what you want it to do. 


The format of a full file specification is: 
dev:[g,m] filename.filety pe; fileversion 
dev: The name of the device that holds the volume on 
which the input file resides (or on which the out- 
put file will reside). 
[g,m ] A User Identification Code (UIC) identifying the 


User File Directory (UFD) that contains (or will 
contain) the file. 


filename The 0-9 character name you supply for the file. 
filetype The 0-3 character type you supply for the file. 
fileversion An octal number that distinguishes between dif- 


ferent versions of the same file. 
Examples of full file specifications are: 


MT1:[116,23]CHARLA.FOO;32 
DM1:[203,204] FOO.FUM;5 
DK2:[34,63 ]WHO.FOO;3 


Chapter 2 describes the file name and file type fields of a file specification. 
The following sections describe the device name and UFD fields. 


3.1 THE DEVICE NAME 

The device name specifies the volume on which the file resides. The name 
consists of two alphabetic characters and an optional 1- or 2-digit octal 
unit number followed by a colon (:). When the name does not include a 
unit number, the system tries to use unit number 0. 
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Device names in the above examples and their corresponding abbreviations 
are listed below. 


Name Physical Unit 

DK2: RKOS5 disk, unit 2 

DM1: RKO6 disk, unit 1 

MTI1: TU10, TEIO, or TSO3 magnetic tape, unit 1 


The device name can refer to one of two kinds of devices: 


e An actual physical device, such as the three listed above 
or 


e A pseudo device which can represent a variety of physical units, 
depending upon which terminal enters the unit name 


For example, the name TI: is a pseudo device that refers to the terminal 
from which input is being entered. When you enter input from terminal 
23 on your system, your physical terminal number is TT23: and your 
pseudo terminal is TI:. When you enter input from terminal 6, your 
physical terminal number is still TT6: but your pseudo terminal remains 
THs 


Therefore, you can either write a program to send output to TT23:, which 
means you will always have to run the program from TT23:, or you can 
write it to send output to TI:, which means it will always send output to 
whatever terminal installs and runs the task. 


Another pseudo device name is SY:, which corresponds to your default 
system disk. All the files created so far in this manual reside on SY:. 


Section 2.3.1 describes the pseudo device LB:, the volume that contains 
libraries. 


Table 3-1 lists commonly used devices. The letter n stands for the unit 
number of the device. There are different types of disks and magnetic 
tapes, which have correspondingly different device names. Ask some- 
one familiar with your system which names you should use. (See the 
RSX-11M/M-PLUS MCR Operations Manual for a complete list of device 
names.) 
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Table 3-1. Device Names and Abbreviations 


Device Abbreviation 


DECtape 


Disk 


Line Printer 


Magnetic Tape 


Terminal 


Pseudo System 
Device 


Because the names SY:, TI:, TT:, and LP: represent input or output 
devices rather than storage media, they usually do not appear in a com- 
plete command line. When you refer to one of these devices in a command 
line, the device name stands alone on one side of the equal sign. For ex- 
ample, the following command sends a copy of ADD.FTN from your 
system disk to your terminal: 


SPIP TLS ANI. FTN ORS 


(; ANN DISPLAYS THE SUM OF TWO NUMBERS 
TYFE 1 

1 FORMAT C7 TYRPE TWO NUMBERS «MeN OO ETNPUT FROME T 
ACCEPT 2yWyl. 

a FORMAT C2i%) 
TYPE Sy hth 

3 FORMAT (7 THE SUM TS “vy TSO INISPLAY RESULT 
STOF 
ENT 
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3.2 USER FILE DIRECTORIES 

When you log on, you either use your login UIC itself or specify it in- 
directly by using your last name. This UIC identifies the default User File 
Directory (UFD) set up for you on your system disk (SY:) when the sys- 
tem manager made you an authorized user. This UFD is itself a file that 
lists the names of all files stored in your directory. None of the system 
programs can locate a file unless they know the UFD in which the file is 
listed. 


The terms UIC and UFD are often used interchangeably in RSX-11M. The 
UIC, however, identifies the user and the UFD identifies the directory. 


When you need to use files stored in other directories, you can use an 
MCR SET command to change your default UFD (SET /UIC=[g,m]) or 
you can specify a UFC in the file specification. The MCR SET command 
changes the default UFD. However, neither of these actions changes the 
UIC under which you logged on. 


For example, if you want a copy at your terminal of a file from another 
UFD, issue the command: 


SRIF TLE#l 3029 2001 CONRAD. MAC LORS 


This command assumes that CONRAD.MAC resides on your default sys- 
tem disk, in UFD [302,200]. 


In a system without multiuser protection, your default UFD corresponds 

to the UIC specified in the last SET /UIC command issued from the 

terminal you are using. 

To display the current default UIC on any system, issue the command: 
SSET AUWTCACK 


When you issue a set command in this form, without specifying what 
UIC is to be set, the system responds with: 


UEC Esty nl 
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CHAPTER 4 
PIP AND THE QUEUE MANAGER 


The following sections introduce two utilities, the Peripheral Interchange 
Program (PIP) and the Queue Manager, and show you how to use these 
utilities to copy files, list the files in a directory, delete, rename, and 
purge files, and print files on a line printer or display them on your 
terminal. 


4.1 PERIPHERAL INTERCHANGE PROGRAM 
The Peripheral Interchange Program (PIP) manipulates files on RSX-11M 
by using appropriate switches to perform the operations. 


Among other things, PIP allows you to 


Copy files from one UFD or device to another 
Delete files 

Rename files 

List directories of files 

Purge files 


Any volume you refer to in a file specification must either be allocated as 
public (available to all system users) or be allocated to you (on multiuser 
protection systems only) and mounted. If any volume specified or implied 
in a PIP command is not mounted or is allocated to another user, PIP 
returns the message: 


PIF «= NEVICE NOT MOUNTED /ALLOCATER 
ede} 3 sty ml 


Device allocation, mounting, and UFD creation are all MCR functions 
accomplished by the following MCR commands: 


e@ ALLOCATE 
e MOUNT 
e UFD 


(See the RSX-11M/M-PLUS MCR Operations Manual for a description of 
these commands.) In the process of creating, editing, compiling and Task 
Building ADD.FTN, RSX-11M created a number of files on disk: 


@ The original source file (ADD.FTN;1) 
@ Anedited version of the source file (ADD.FTN;2) 
e An object file containing the compiled program (ADD.OBJ;1) 
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A task image file containing linked object code (ADD.TSK;]1) 

A memory allocation file (ADD.MAP;1) 

A symbol definition file (ADD.STB;1) 

Additional versions of the above files, if you repeated any of 
the program preparation steps 


All of these files remain on disk taking up space until you explicitly delete 
them. RSX-11M does not automatically eliminate old versions of files. 
(Appendix A includes an example of how consecutive operations can 
create multiple copies of files.) 


You can invoke PIP from MCR in either of two ways: 


1. The single line format, which executes one PIP command and 
returns control to MCR: 


PLP 7 LLL 


QTRECTORY TROSKSO1Ls 3147 


LanFEBe 7S O9310 

ATIF TNS 3 Ie eee PER 29 LLs ad 
ANN FTNG 2 we eee KERB 2P Lego 
ALTA P TNS 1 sae L?-F ER 79 Ld ge 
or 


2. The format that passes control to PIP and allows you to execute 
multiple PIP commands: 


PE LE CR 
PIF /LISCR 


QIRECTORY TROSKSOLy S147 
L4n-FER@ 79 O93 10 


ANNs FTN G3 Le ii) as ew ae 4 


Lid34e 
ATT. FTN G2 ar eek EB ZO Lesog 
ANT. FTN GL Ls L?-FER<-79 11232 
TOTAL OF 44/11. BLOCKS IN 3. FILES 


PIF? Ant.FTN /PUSCR 
PIE 


This chapter uses the one-line form shown in number | to illustrate PIP 
command operations. Any command shown here can also be executed in 
the method described in number 2. 
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4.2 PIP COMMAND LINE AND DEFAULTS 

The format of PIP command lines differs for each function. In general, 
however, PIP switches operate on lists of file specifications. PIP uses the 
last value it encounters in a command line as the default value for that 
command. 


You can enter multiple file specifications in a single command line by 
separating the individual file specifications with commas. The switch 
follows the last file specification. 


In the following example, PIP will delete the files named ARRAY.FTN;]1, 
MULT.FTN;1 and HEX.FTN;1: 


2 FIP ARRAY. FTNG Le MULT FTN Le HE KAP TN DL ADE R 
The individual file specifications within the list must each meet the 
requirements of the PIP switch involved. Therefore, all of the files being 
deleted in the example must include version numbers because the PIP 


Delete switch requires version numbers. 


Table 4-1 summarizes the PIP switches which are described in this chapter. 
(See the RSX-J 1 Utilities Manual for additional information on PIP.) 


The following sections describe and illustrate the use of these commands. 
4.2.1 Displaying a File on Your Terminal 


To display a copy of ADD.FTN on your terminal, enter a PIP command 
in the following format: 


2 PIE TEA. PTNECK 
This command produces the following display: 


TYFE 4 


1 FORMAT ¢€¢% TYPE TWO NUMBERS ~ MeN%) TRPROMPT FOR 


ACCEPT 2eKyol. 
2 FORMAT (210%) 
TYPE Se h +L. 


3 FORMAT ¢¢ THE SUM ITS “’9IS) !0TSFLAY RESULT 


STOF 
ENT 
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Table 4-1. PIP Switches and Command Functions 


Prints the names of requested files con- 
tained in the specified UFD. 


Prints a shortened version of the directory 
generated by the list command. 


Deletes the files specified. 


Purges (deletes all but the highest num- 
bered version(s)) of the files specified. 


Spools (lists on the line printer) all files 
specified. (Note that you can also use the 
Print command of the Queue Manager for 
this function.) 


/RE Renames the input file(s). 

/CO Contiguous Copies the file into contiguous blocks on 
the output volume. 

/TR Truncates unused blocks at the end of the 
file. 


/CD Creation Date 


Copies the file, using the original creation 
date, instead of updating it to the current 
date. 


Selective 
Delete 


Deletes the files specified, after asking you 
whether you want to delete each particular 
file. 


4.2.2 /LI — Displaying Your User File Directory 
All of the files you create are listed in your UFD. The PIP /LI command 
displays the UFD as follows: 
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PEP 
DIRECTORY 
LO“FER=79 


/L.tectr: ©@ 


QROSTR1LOe 76.1 
14248 
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© © °o °o oe 
ANT. ORS 92 we ee AN 2S LAs Sd. 
ANY. TSN #1 LP. C 2m JANN FZ? 14s an 
AT. MAPS 1 4 ( Se ANN FS 14338 
ALN. STERs 1 Je LeeJAN@ 79 TOs a? 
ALI TN S$ I ‘Le LO- JAN 79 B14 
ANN. TSK GS oP? s ( Bem TAN ZEW e 
ANT. OWI ae 29 OEC7B 1.534 
ALIN. TSK G2 me? ¢ ( 29 TEC 7B 1.330: 


TOTAL. 


OF P9./1126 
7 


BLOCKS IN & FULES 


The PIP /LI version of the command includes the following information, 
keyed to the numbers in the directory above: 


The physical volume on which the files are stored, and the UIC 
that owns the directory. The volume named is your default sys- 
tem disk (SY:). The UIC is your default UFD. 


The date and time PIP created the directory listing. 
The name, type, and version number of each file. 


The number of blocks used by each file. A block is 512 bytes 
(256 words) long. 


A file code which indicates the file is either contiguous (C code), 
noncontiguous (no code), or locked (L). Locked files usually 
contain corrupted data. You can access them by using the PIP 
Unlock switch (PIP filename/UN). 


The date and time each file was created. 


The cumulative size in blocks of all the files listed and the num- 
ber of blocks allocated to all the files. 


PIP also provides switches to control the amount of detail given in the 
directory listings. The BR switch causes PIP to generate a directory in 
brief form. For example, the command PIP /BR causes PIP to print a 
directory on your terminal in the form: 
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PIP / BRECK 
VIRECTORY UBLICBOB 123 
ALTE TNE S 


ALITE. FTN G 2 
ANY. FTN GL 


The FU switch causes PIP to print a directory in more detailed (full) form, 
as shown in the following example: 


PIP /FUZCR> 


NIRECTORY ELI C3O3%129 
2I-FER-79 14349 


@ © 
AINM.F TN 3 C1437 927) 7b eS 73 LOPE BH PAY 
e@ 0 
C3037129 CRWETy RWET sy RWED yy Fe 2 FEBE 79 1430704.) 
ADM. FING 2 C4h2046922) tae ae Oe 2Om RE Bs 79? 
C3032127 CRWED sy RWEN ys RWED y Fe ele FER 79 14¢22¢4.) 
AlN. ORF 1 C21142 93) 56454764. LO FER 72? 
ESOS 2127 CRWEDy WED y WED y Fe ee PER 79 14322064.) 


This form provides the following information (in addition to the informa- 
tion explained in the preceding example): 


@ A file identification number consisting of the file number and 
the file sequence number. This information is used by the 
RSX-11M file system to keep track of your files. 

© Blocks allocated to each file (in addition to the blocks used). 


A protection code which tells how your file can be accessed 
by other system users. 


@ The date and time the file was last revised and the number of 
revisions. 


After displaying the directory in any of these forms, PIP returns control 
to MCR. 


4.2.3 Display Information on Specific Files 

PIP allows you to obtain information about one file or a specific group of 
files in a directory. For example, if you want to see how many versions of 
ADD.TSK exist in your directory, issue the command: 


“ETP AMIN. TSKIR /LICRS 


L4Asad 


L3s4d 
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As the example illustrates, the file specification always precedes the 
switch. 


The command requests PIP to display a directory of all versions of the file 
called ADD.TSK. The asterisk (*) in the version number field tells PIP to 
search for all versions of the file. 


The asterisk (*) character in one or more fields of a file specification 
stands for all. This is also called a wildcard specification. PIP restricts 
the use of wildcards in the cases listed below. 


The following restrictions apply to PIP output file specifications: 


1. Copying a single file 
. Listing a directory 

3. When you copy several files, the output file specification must 
be *.*;* or default. 

4. The output specification, used with the Rename and Enter 
switches, can mix wildcards with specified fields. With either 
switch, PIP uses the equivalent field of the input field specifica- 
tion. 


In all cases where PIP permits wildcards in the output file specification, 
the wildcard UIC form [*,*] is used to indicate that the output UIC is 
the same as the input UIC. 


The following restrictions apply to wildcards on PIP functions with input 
files: 


— 


* *-%* means all versions of all files in the current UFD 
2. *.DAT;* means all versions of all files of file type DAT in the 
current UFD 
3. TEST.*;* means all versions and all types of files with the file 
name of TEST in the current UFD 
4. *.* means the most recent version of all files in the current 
UFD 
5. *,.DAT means the most recent version of all files of file type 
DAT in the current UFD 
6. TEST.* means the most recent version of all file types for files 
named TEST in the current UFD 
7. TEST.DAT means the most recent version of TEST.DAT in 
the current UFD 
8. [*,*] meansall UIC group, member combinations from 1 to 377 
9. [nl1,*] means all UIC member numbers under group nl 
10. [*,n2] means all group numbers for member n2 


ADD.*;* refers to all versions of all types of the file named ADD in the 
current UFD. 
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4.2.4 Deleting Files 

Once you know what files are listed in your UFD, you can decide which 
files you want to delete. For example, to retain the highest numbered 
version of each of the files listed in Section 4.2.2, you would delete the 
following files: 


ADD.OBJ;1 
ADD.TSK;1 
ADD.TSK;2 


To delete these files with the PIP Delete switch, issue the following com- 
mand: 


SPIF AND.OBJ9 Ly ALIN. TSN FL ANN. TSK § 2 SOCKS 


Note that the Delete switch requires either an explicit version number or 
a wildcard in the version field. However, the use of a wildcard is inappro- 
priate when your UFD includes files with the same name but other types 
and versions that you do not want to delete. In this instance, you must 
specify explicitly each file you want to delete. 


4.2.5 Purging Files 

When you want to eliminate all but the highest version of files, the PIP 
Purge switch is often more efficient than the Delete switch. The follow- 
ing Purge command has the same effect as the above Delete command: 


SPIF ADU. K /FULCRS 


Purging does not affect any files in your UFD which only have one ver- 
sion. Note that the file specification for the Purge switch does not include 
a version field. After you issue the above command, you can issue the 
following command to see what files remain in your directory: 


SPIP SLICK 


QIRECTORY OBOE SOL y 31434 
Lae FER 22 O98 10 


ANN. ORF 2 me ed AN 2? 
ADT. MAF # 1. 4, a AN 2S 
ALK. STE 1. 3 wd AN 2 Y 
ALL. FTN I. 1. Om JAN 29 
ALIN. TSK #3 me Ps C md JAN 2D 


TOTAL OF 39.749. BLOCKS IN SG FILES 
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As the listing shows, the UFD now contains only the highest version of 
each file. 


4.2.6 Selectively Deleting Files 

The PIP selective delete command prompts for your response before 
deleting a file. The responses allowed (<CR>, ~Z,Y,N,Q, and G) cause the 
following action: 


Letter Terminator Operation 
Y <CR> Deletes file and continues 
Y “Z Deletes file and exits from PIP 
N <CR> Saves file and continues 
N “Z Saves file and exits from PIP 
NULL <CR> Saves file and continues 
(no response) 
NULL “Z Saves file and exits 
Q <CR> Saves file and returns to command 
mode. 
Q pA Saves file and exits from PIP 
G <CR> Deletes this and all remaining can- 


didates for deletion, lists deleted 
files, and returns to PIP command 
mode. 


G “Z Deletes this and all remaining can- 
didates for deletion, lists deleted 
files, and returns to MCR. 

You can specify the Selective Delete switch (/SD) as follows: 
PLP AYN OkKex /STECKS 


PIP responds: 


QELETE FUE OBL eh sO3s aI AT. FTN 
DELETE FILE DRI So SOS¢ 1 2 At. ORS 


¢ 


FL RYAZNAG/QITY 
G1 LYYNZG/Q 07 


+ 


Y 
N 
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In response to your answers, PIP deletes ADD.FTN;1 but does not delete 
ADD.OBJ;1. 


4.2.7 Copying Files 

Copying files is PIP’s default function; that is, if you enter a legal PIP 
command line with no switches, PIP performs a copy operation. For 
example, the following command copies the file ADD.MAP from your 
UFD on SY: to your UFD on DK:. 


=PIP DK? ANN. MAP ECRS 


The command includes the call to PIP, followed by a file specification in 
the form: 


outfile=infile 
infile 

The file to be copied 
outfile 

The new copy of the file 


When you omit the UFD, file name, file type, and/or version number in 
outfile, PIP defaults the UFD to your default UFD and the name, type, 
and version number of the file to the equivalent fields in the input file. 


Before you can copy a file to a directory on another volume, the directory 
must exist on that volume. In a multiuser protection system, your direc- 
tory on SY: is the only UFD automatically created for you; and in a non- 
multiuser system, no UFDs are automatically created. If the output 
volume specified in the above example does not contain a UFD corre- 
sponding to your UIC, PIP returns the message: 


REP: es CANNOT FING OTRECTORY FTE 


mens sty in 


4.2.8 Renaming Files 
The PIP Rename (RE) switch allows you to rename existing files. For 
example: 


SPIFP ALITWO ke Ke ANN KEK SRC 


This command tells PIP to change the names of all types and versions of 
the files named ADD to ADDTWO. Note that you must explicitly specify 
either a number or a wildcard in both input and output version fields 
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when you use the Rename switch. The wildcards in the output file speci- 
fication indicate that the type and version of the renamed files remain the 
same. The directory now contains the following entries: 


NIRECTORY NBROSE SOL: 314) 
4~-AUG$78 3203 


ALNTWO .OBIF2 ar Qe JAN 79 143 37 
ANTITWO .MAF ET a, eae IAN 79 143 32 
ALNTWO .STRS 1. Be eae AN 79 14534 
ALDNTWO «FTN 1 ls 2O~ JAN 79 UGE 24 
ANUTWO «TSK ES aD C LO-JAN@ 79 O25 4S 


TOTAL OF 39.749. BLOCKS IN S FILES 


Because the renaming function does not transfer data, you cannot specify 
a different device in the output file specification. If you want to rename a 
file as you copy it to another volume, enter the new name in the output 
specification of the COPY command line. For example: 


SRIF TNC ATITWO 6 Ko RATT 6 KF KCK 


This command tells PIP to copy all types and versions of the file named 
ADD, which are stored in your UFD on SY:, to an equivalent UFD on 
the DK: disk, unit 0, where they will be named ADDTWO. 


4.3 THE QUEUE MANAGER 

System users often need to have copies of their files printed on the line 
printer. Consequently, the line printer is in heavy demand. An RSX-11M 
task called the Queue Manager provides for orderly use of the line printer. 
It does this by maintaining a queue of files to be printed according to 
their priority, time of request, and other factors, and by displaying infor- 
mation to let you know your file’s place in the queue. 


4.3.1 Printing Files 
To send files to the line printer queue, you use the Queue Manager PRINT 
command, as follows: 


SPRINT AN. MARCI 


Note that you do not need to specify LP: or any other output file. This 
command asks the Queue Manager to enter ADD.MAP to the queue of 
files waiting to be printed. The system maintains the queue by file name 
and file identification number, copying each file or group of files to the 
line printer, usually on a first queued, first printed basis. The system also 
allows you to specify that files be printed after a certain time or date. 
Check the RSX-// Utilities Manual for more information about the Queue 
Manager. 


4-11 


PIP and the Queue Manager 


4.3.2 Listing Files in the Queue 
To determine whether a particular file is in the queue, waiting to be 
printed, type the following Queue Manager command: 


QUE /LISTACKS 


The names of all the files waiting to be printed will be displayed on your 
terminal in response to this command in the following format: 


XK PRINT QUEUES Ox 
@ FRINT # LEO? 
303 ¥ 3O C1) MP REF (20009 3276) ACTIVE ON LOS 
NBOSE SOS y 4 IMREP . OCs 1 
O ( UBOSLSO2y SLOTANL FTNG 1. 
QRDSCLOO~s LIAS. FTN 2 


@ Identifies the file currently being printed, its file identification 
number, name, and the printer. 


@ Names of the files waiting in the queue to be printed. (These are 
listed in the order in which they will be printed.) 
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SAMPLE FORTRAN PROGRAM 


The following listing shows the development of the FORTRAN-IV pro- 
gram, ADD.FTN, and the manipulation of the resulting files. The listing 
illustrates how rapidly you can create numerous versions of the same file, 
and what to do to eliminate the old versions. 


What you type on your terminal is printed in red; what the computer 
prints on your terminal is printed.in black. 


“HEL ACR 
ACCOUNT OF NAME3 CONRADS CR: 
FASSWORTE ACK 
RSXe@LIM BL26 MULTI-USER SYSTEM 


GOOD MORNING 
Le-JAN@79 19337 LOGGED ON TERMINAL TT32% 


Len IAN 79 


SYSTEM WILL BE TOWN TOMAY FROM 13200-15200 


“EDT ADD. FTN CR: 

CCREATING NEW FILE 

UNF UT 
TYPE Lacks 

il FORMAT ¢€% ENTER TWO NUMBERS ~ MyN SCR 
APPENEPPACCEPT 29 Ky LOR Ck 
ACCEPT 29 hy Latkes 

4 FORMAT (222N22NTS) <CRE 
PRINT “U 
TYPE Se K+L Cr 

3 FORMAT ¢° THE SUM TS ‘/9 TS <0 
STOP ACK 
ENE CR 


Sample Fortran Program 


“PIF TES Ant. FTNECRS 


PYRE I 
1 FORMAT (7 
ACCEPT yk 
i FORMAT C2T 
TYPE Sy KHL 
3 FORMAT ¢7 
STOF 
RNY 


PEDY AND. FTNECRS 
LOO008 LINES REATI 
PRPAGE 12 

KLOCATE ENTERA CR 

1. FORMAT ¢% 
KCHANGE /ENTER/ TYPE 
i. FORMAT ¢7 
KNEX TACK 

XP ROINT ACR 


ENTER 
yi. 
yh) 


TWO NUMBERS 


THE SUM TS “9 TS) 


ING 


ENTER 
JE CR 
TYRE 


ACCEPT 2yeKel. 


XLOCATE SUMECK 
3 FORMAT ¢7 


THE $ 


KCHANGE/SUM/RESULT/2CRS 
THE RESULT TS “y»T%) 


% FORMAT (/ 
XLOCATE (2TS)<CR> 
CKEORX 
ATOP ACR 
KCK 

TYFE 
AEXITACR? 
CEXITS 


A-2 


TWO NUMBERS ~ 


TWO NUMBERS 


UM IS ’9TS) 


My? 3 


MyN% > 


MyN%) 


Sample Fortran Program 


MENT AYP TNE CRS 

LOO0008 LINES REA ING 

CR AGE tc 

XINSERTACK: 

C THIS FROGRAM ALNNS TWO NUMBERS<CR> 


KCK 
C THIS FROGRAM ANNS TWO NUMBERS 
XLOCATE NUMBERS ACR 
A FORMAT (4 TYRE TWO NUMBERS - MyN%) 
KANT TEROMET FOR TNFEUT EGR 
APRON TOR 
1 FORMAT ¢€¢7 TYRE TWO NUMBERS ~- MyN%) IP ROME T FOr 
KXLOCATE RESULT OR: 
3 FORMAT (¢ THE RESULT TS “9 TS) 
AE LE TES ORS 
KLESC 
TYRE Sy KL. 
XTNSERT ORE 
3 FORMAT ¢€° THE SUM IS “TS INISFLAY RESUL TACK 
“OR 
XTORACKR 
KCK 
(" THIS FROGRAM ANNS TWO NUMBERS 
XRETYFE © AMM DISPLAYS THE SUM OF TWO NUMBERS ACK! 
KLIS TCR: 
( ALY NISFLAYS THE SUM OF TWO NUMBERS 
TYRE 1 
1. FORMAT ¢€% TYPE TWO NUMBERS ~ MyN4 > EINEUT PROMPT 
ACCERT 2yWKyl. 
ie FORMAT (2tS) 
TYPE Sy W+L. 
a FORMAT ¢€% THE SUM TS “+s TS INISFLAY RESULT 
STOF 
ENY 
KE XT TACKS 
REX ITS 


“PIP ALT KEK AL TCR 


DIRECTORY UBL 30 303% 12% 
OMA 7?9 20309 


ALITY 6 F TNS 3 il 
ALNTI.F TNS 2 1 
ATT. FE TNS 1 1 


Ob —MAY 72 20308 
OG"MAY@79 20807 
ObMAY79 Lesa? 


° < ° 


TOTAL OF 3.46/79. BLOCKS IN 3. FILES 
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“FOR ADTEAINE CK 


PIP AL. KIX LTC 


QERECTORY DELIL SOS 1209 
OMAY@ 79 20510 


O4G"MAY 79 LPs 4? 
Ob MAY 79 2OL0?7 
OG MAY 29 20000 ’ 
O4o—MAY 79 BOO? 


ALD. F TNS 1 
ALQLFTNG 2 
ANT F TN 3 
ALT. OW IF 1 


rp et Re 
c- © + 


> 


’ 


TOTAL OF S./720. BLOCKS IN 4. FILES 


“FOR 9» AI -SPeAnN CRS 
*MAIN. 
SP IP ALM. KI ALT CRS 


OIRECTORY DELL SOSs 1279 
Om MAY 79 20210 


AYNLFTNG 1 ls OS "MAY 79 1924? 
ANU. FING 2 le OG MAY R279  2OR07 
ANU. FTNG 3 1. OS MAY 79 20708 
AND. OBIF 1 ae O4G—MAY 279  2O30° 
AQNO.LST sy 1 ee OG—MAY R79 20319 


TOTAL OF 7.725. BLOCKS IN 3. FILES 


“FOR y ALTE ALTE CK 
+MAIN. 
“PIF AD. KEK ALTA CR 


QIRECTORY YELEC S039 124 
OMA 79 20810 


Ob—MAY 79 LOCA? 
QG—MAL 79 SOCO? “ 
OG MAY 79  BOSO3 
OG MAY 79 BOSCO? 
Qb—MAY 29  2OGTO 
OG MAY 79 2OT12 


ALY. FTN 1 
ANU. FTNG 2 
ALN. FTN 3 
ANT. OBIS 1 
ALN. LOT eh 
ANT. LST #2 


7 Iw 


2 FD PS ee ee 


~~ 
+ * > + + > 


TOTAL OF 94730. BLOCKS IN 6. FILES 
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SFOR ADIN ANI/-SPeAnI Ck 


+MAIN: 
SPIP ALM. KIRK SL TOR 


CIRECTORY ELEC SO391 29 
Se MAY 79 2OS12 


ADDF TNG 1 
ANTILFTNG 2 
ALN. FTNG 3 
ANY. OR 9 tt 
ANU. LST I. 
ANN LST 2 
ANT. OBS 2 
ALN LST $3 


TOTAL OF 13-740. BLOCKS I 


*POR ADT ANU2 ANNA CK > 
oMATN, 
SP IP AIM. KEK SLICK 


CIRECTORY DELICE SOS 9129 
Oe MAY 79 BOLLS 


ANT. F TNS 1. 
ALTE FTNG 2 
ALLL F TN 3 
ANN. OFT 
AYNALS Ted. 
ANN. LST H2 
AT. ORIG 2 
ANN LST #3 
ANN. OBIE S 
ANY. LSOT 94 


TOTAL OF 17.750. BLOCKS 


iPrhIORe ee 


ee 


Fae eae ee 


ow 
- ? ? a ° > >. La 


> + 
a‘ 


— 
= 


Bs 


LO. 


PTL SS 


PLES 


Sample Fortran Program 


O& 


Ob-MAY: 
“MAY 75 


O04 
OG 
Od 


O4~ 
Od 
Gas 
Odo 
O6~ 
Aes 
06~ 
O&~ 
Od 


Od 


“MAY ~75 


Ob—I 
06~ 
O6~ 


MAY 


MAY~ 


M4 rc) Y ae J 
MAY? 


MAY: 


MAY: 


L924? 
LOO? 
Os OD} 
LOOP 
e2Os 1a 
ee Li 
2Oede 
mOs Le 


LPS 47 
es? 


2 Os OD 
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Sample Fortran Program 


STKE ADDEALISOR? 


[RES XNTAGK- 13 UNCER INET 


ANT MM 
EOL. 
LCOS 
TRS 
TF WS 
TSN & 


MOL SMM 
PEL 
STPS 
TULS 
$OT I 
$OTSVA 


SPIE ANY. koe AL TCR 


QIRECTORY WEIR SOS~ 127 
OMA 79 20316 


ALT. FTN F 1 
ALNT.F TN 2 
ANTI. FTN§ 3 
ALN. ORF 1. 
ANNE LST $1. 
AMN.LST #2 
ALT. OB WF 2 
AMIN. L ST #3 
ANT. OBI 
ALN. LST $4 
AN. TSK FI. 


TOTAL OF 21.754. BLOCKS 
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1. 
1 
Ll 
a + 
me 
ae 
ee 
me 


me 
oy 


au + 


4 


TN 


SYMBOLS SEGMENT 


Lid. 


C 


FXLES 


O4- 
O4— 
046~ 
0) by 
06» 
04> 
QOd-~ 
Ode 
Odo 
OG 
OG 


ANN 


MAY<79 


MAY~79 
MAY~79 


“MAY~79 


MAY~79 
MAY=79 


MAY 49 


Lesa? 
2O2O? 
29203 
e232 OY 
me O3 19 
mOe Le 
eOSL2 
203 12 


203 13 


2O3 13 


x 


o. 
4. 


L4 


Sample Fortran Program 


“TRE yANU/<-SPeANNy LB tll y LIFOROTS/L BCR 
RTF ANI. keK ALT ORS 


IIRECTORY BLE SOS7 127 
GMA 79 20818 


ANT. F TNS 4. 1 OG MAY 79 LPT a? 
ANTI. FTN 2 Le OS MAY FE 2OEO? 
ALT. FTN 3 le Ob "MAY FP  2OLOD 
ALT. ORF 1 ae OG—MAY R29 2020? 
AN LST 1. me OG MAY 29 20819 
ALN. LST #2 ae OG MAY 79 20312 
ANN. ORIG 2 ae Qb—MAY 79  2OTR 
AND. LST #3 ae OS—MAY 79 2OCTR 
ANT. OHI 3 ee OG MAY 79 208: 
ANIMAL STs 4 ae OG" MAV 7P 208 
ALN. TSK go. As C Ob MAY GP 20% 
ALT. MAF ¢ 1. 14. OG MAY FP B08 


TOTAL OF 35.769. BLOCKS IN Le. FILES 


“TKE vADNAITHANT ys LR SIL» LIFOROTS/L BACK 
PTF AL. KK ALTOS 


QIRECTORY DELS E 30039 1270 
Se MAY 79 20389 


ANTI F TNE 1. le OGM MAY 2 PF LPT 4a? 
ALT. FTNS 2 ls IG MAL 29 20307 
ALT. FTNG 3 ‘le OS MAR 2 P 20509 
ALI. ORF ae OG MAY 7P ROO? 


ALIN STF 2 et OG MAY 79 20018 
ANT. ORF 2 ae OG MAY FF 2OeTR 
ANIL. LST § 3 me OG MAY 7P 2001 
ANT. ORS 3 a+ OG—MAY27P 205 
ALNLL STH 4 ae OG MAY 29 2OS 
AQT. TSN $F 1. 4, (’ Ob—MAY 69 208) 
ATI MAF S 1. 14. Ob MAY 29  2OeT 
ATT. MAPS 2 Las Ob MAY 79 BOs 
ANT. STHRE I 4, O4G—MAY 279 205 


TOTAL OF S3./789. BLOCKS TN 14. FILES 
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Sample Fortran Program 


“TRE ADL AND ANNEAL LEI LL y LIFOROTS/LES 
PIP ALD. KEK /LISCR: 


NIRECTORY NBII 3039123 


b-MAY 29 


AL. FTN 1 
ALTAR TNE 
ALD. FTNG 3 
AND. ORS 1 
AVIS L ST sd. 
ALIN LST § 2 
ANN. ORI § 2 
AIL ST ys 
ANT. OBIS 
ANU.LST 94 
ANT. TSK EI 
AL. MAP 9 1. 
ALT. MAP SE 2 
ANN. STH A. 
ANN. TSK gs 2 


ANTI.MAF s 3. 


ANU. STBs 2 


TOTAL OF 


“FIP AD. K /PUSCRS 
PIE ANN. KIX SLISORS 


QIRECTORY WRLC SOS» 129 


ANIL. FTNGS 
ANI. OFFS 
AN. TSK 2 
ALT. MAP ES 
ANN. STRs 2 


TOTAL OF 


A-8 


ROFL 


LO4¢ 7142» 


2O8 1? 


Oe /O8 > 


ae 
oe 
oe 
ao 
ae 
a ¢ 
ae 


BLOCKS IN 17. FILES 


‘le 
me 
me 
33. Gy 
14, 
A. 


IN 6+ FOULES 


(OPS 


OO" MAY 79 
OG MAY 29 
OS MAY 79 
Ob MAY 29 
OG MAY 79 
OS—“MAY~79 
OG MAY 79 
O46 MAY 29 
06 MAY 79 
OMAN 79 
OS~MAY &9 
Ob MAY 79 
DG"MAY 79 
OG"MAY 79 
Q&MAT «79 
O4—~MAY 79 


O6—MAY 79 
OG-MAY~79 
Ob6—MAY~79 
Ob—MAY 79 
O6—MAY 79 
O6"MAY 79 


LOA? 
e2OeQ? 
2QeQg 
mQe QO? 
eO3 19 


od 


*% 
¢ 
> 
e 
¢ 
Vd 
Qs 
+ 
* 
% 
ef 


Sample Fortran Program 


SRIF AL KER STREC 
PIE ALM. KIRK ALTOS 


QIRECTORY DRI G SOS 9 120 
So MAY@ 279 2027 


ANT. FTN 3 le OG MAY 279 20803 
ANT. OBIE 3 ao OO—MAV 72 BOIS 
ANU LST #4 ae Oo MAY 29  2O3 13 
ALN. TSK $3 33 ( OG@MAY R79 BOTS 
ALT s MAF #3 14. OS MAY 279 20805 
ANN. STRe 2 Ae Ob“MAY 79 20513 


TOTAL OF Sé./56. BLOCKS TN &. FILES 


Note that the dlast ster reduced the munmber of tplocks 
glloceted to tmne 6 files in the cirectors. 


2RUN AQACKS 

TYFE TWO NUMBERS - MeN 
8» SCS 

THE SUM IS i? 
Ese. "Color 


RUN ATIIEICRS 

TYPE TWO NUMBERS - MeN 
439 S40 

THE SUM IS we 

6 ee STOF 


RUN ADNIEICK 

TYFE TWO NUMBERS - MyN 
PPB» 2iCKS 

THE SUM TS 1001 

TTSRs. re STOr 
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A 


ADD.FTN, 
creation of, 2-2, 2-3 
editing of, 2-4, 2-8 
Assembly process, 2-1 


Bell character, 1-6 
Blocks, 
allocated, 4-5 
total, 4-5 
used, 4-5 


C 


Carriage return < CR >, 1-4, 1-8 
Code, 
binary, 2-1 
machine readable, 2-11 
Communication, 
interactive, 1-1 
system to hardware, 1-1 
terminal to system, 1-1 
Compile, 2-1, 2-11 
Compiler defaults, 
file type, 2-11 
object file, 2-11 
source file, 2-11 
switches, 2-12 
Compiler, FORTRAN-IV, 2-11 
listing file, 2-12 
omitting output files, 2-13 
storage map, 2-12 
switches, 2-12 
Computer Language, 2-1 
Computer Languages, 2-1 
Assemblers, 2-1 
COBOL, 2-1 
Compilers, 2-1 
FORTRAN-IV, 1-9 
Syntax, 2-1 


E 


EDI, 2-1 
EDI commands, 
ADD command, 2-7 


BOTTOM command, 2-5 
CHANGE command, 2-5, 2-6 
< CR> command, 2- 5, 2-6 
DELETE command, 2-7, 2-8 
< ESC > command, 2-7, 2-8 


EXIT command, 2-4, 2-7, 2-9 
INPUT command, 2-3 
INSERT command, 2-7, 2-8, 2-9 


INDEX 


Index-1 


EDI commands (Cont.) 
KILL command, 2-4 
LIST command, 2-7, 
LOCATE command, 


-5 
RETYPE command, 2- 
TOP command, 2-5, 2- 
TYPE command, 2- 7 
EDT, and CRT terminals, 2-2 
Error message formats, 1-12 
Escape < ESC >, 1-8 


- 


File, 2-1 
File specification, 

compiler input, 2-12 

compiler output, 2-12 

device, 3-1 

file name, 3-1, 4-11 

file type, 3-1 

file version, 3-1, 4-11 

RSX-11M, 3-1 

Task Builder input defaults, 2-15 

UFD, 3-1 

UIC, 3-1 

Task Builder output defaults, 2-15 
File type, 

BAS, 2-2 

CBL, 2-2 

F4P, 2-2 

FTN, 2-2 

MAC, 2-2 

standard, 2-12 
File, 

contiguous, 4-5 

creation of, 4-1 

explicit deletion of, 4-1 

locked, 4-5 

noncontiguous, 4-5 

other directories and, 3-4 
FORTRAN-IV compiler, 2-11 

command line specification, 2-11 

defaults, 2-11 

Object Time System Library, 2-15 
Function keys, use of, 1-3, 1-4 


Interactive program, 2-2, 2-17 


L 


Language translator, 2-1 
LB:, 2-15 


Line Printer, 
priority, 4-11 
timing, 4-11 
Line Text Editor (EDI), 
Creating new file, 2-2 
Editing existing file, 2-4 
Edit Mode, 2-4 
File version numbers, 2-7 
File names, 2-2 
File specifier, 2-2 
File type, 2-2 
Input Mode, 2-3 
Invoking, 2-2 
Linking, 2-1, 2-14 
Listing file, 
displayed on terminal, 2-13 
without object file, 2-13 
Loading, 2-14 
Logging on system, 1-10 
other user on system, 1-10 
short form, 1-10 
suppressing messages, 1-10, 1-11 
system messages, 1-10 
LP:, 3-3 


Monitor Console Routine (MCR), 1-5, 1-6 
command line, 1-6, 1-7 
default prompt, 1-8, 1-10 
error messages, 1-12 
explicit prompt, 1-6, 1-8 
implicit prompt, 1-5, 1-8 
keyword, 1-7 
parameter, 1-7 
terminator, 1-7 

MCR ABORT command, 1-7 

MCR ALLOCATE command, 4-1 

MCR DISMOUNT command, 1-7 


MCR HELLO command, 1-7, 1-8, 1-9, 1-10 


MCR HELP command, 1-6, 1-8 
MCR MOUNT command, 4-1 
MCR RUN command, 2-13, 2-16 
executing task, 2-16 
loading task image, 2-16 
locating task, 2-16 
MCR SET command, 2-1, 3-4 
MCR UFD command, 1-7, 4-1 
Multiuser protection system, 1-8, 3-4 
logging on, 1-8 


N 


Nonmultiuser protection system, 1-8 
Nonresident compiler, 

installation of, 2-13 

removal of, 2-14 


INDEX 


Index-2 


O 


Object module, 2-1, 2-14 
creation of, 2-11 
Operating System, 
communicating with hardware, 1-1 


function of, 1-1 
MCR and, 1-5 


Pp 

Password, 1-9 
acquiring, 1-10 
echo, 1-9 

Physical device, 3-2 

Peripheral Interchange Program (PIP), 4-1 
blocks allocated, 4-6 
command line defaults, 4-3 
file identification numbers and, 4-6 
file protection code, 4-6 
invocation of, 4-2 
multiple line format, 4-2, 4-3 
revision date, 4-6 
single line format, 4-2 
switches, 4-1 
wildcard restrictions, 4-7 

PIP functions, 
copying files, 4-1, 4-20 
deleting files, 4-8 
displaying brief UFDs, 4-5 
displaying files, 4-3 
displaying full UFDs, 4-6 
displaying UFDs, 4-4 
purging files, 4-8 
renaming files, 4-10 
selectively deleting files, 4-8 

Pseudo devices, 2-15, 3-2 


Q 


Queue Managers, 2-12 

Queue Manager, 4-1, 4-11, 4-12 
listing command, 4-12 
Print command, 4-11 


R 


Return < RET >, 1-4 
RSX-11M Tasks, exit from, 1-6 
RSX-11M Utilities, 4-1 
Rubout, 1-4 


S 


SLP, 2-1, 2-2 

Source file, 2-1 

Source File, Creating, 2-1 
Languages, 2-1 

Source Language Input Program, 2-1 


Spooling, 

automatic of listing file, 2-12 
SY:, 3-2, 3-3 
Symbols, resolution of, 2-12 
System disk (SY:), 3-4 

default, 3-2 

files stored on, 2-13 

multiuser protection, 2-13 

nonmultiuser protection, 2-13 
System message file, 1-10 
System message file, required messages, 1-10 


T 
Tab, 1-4 
Task Builder, 2-14 
full command format, 2-14 
global symbol definitions, 2-14 
LB switch, 2-15 
MAP file type, 2-12, 2-16 
multiline command format, 2-15 
OBJ file type, 2-14 
omitting input files, 2-15 
omitting output files, 2-15 
output files, 
memory allocation file, 2-13 
symbol definition file, 2-13 
task image file, 2-13 
oversize command line, 2-15 
resolution of symbols, 2-12 
short command format, 2-15 
STB file type, 2-12 
switches and options, 2-16 
TSK file type, 2-12 
Task image file, 2-1, 2-14 
Task prompt, 
DIGITAL supplied software, 1-8 
user-written software, 1-8 
Terminal, 
CTRL/O, continues output, 1-5 
CTRL/Q, suppresses output, 1-5 
CTRL/O, suppresses output, 1-5, 1-6 
CTRL/S, continues output, 1-5, 1-6 
Cathode Ray Tube (CRT), 1-1 
control keys, 1-3 


INDEX 


Index-3 


Terminal (Cont. ) 
function keys, 1-3 
hardcopy, 1-1 
initial default values, 1-9 
input from, 1-6 
keyboard, 1-3 
LA36, 1-1 
local/remote switch, 1-8 
state of, 1-8 
suppressing output, 1-5 
system access through, 1-9 
using the, 1-1 
VT100, 1-2 
VT100 keyboard, 1-3 
VT52, 1-2 
VT52 keyboard, 1-3 
Text file, 2-1 
TI:, 1-8, 3-3 
Typeahead buffer, 1-6 


U 


UFD, 

changing, 3-4 

default, 3-4, 4-19 

nonmultiuser protection, 3-4 
UIC, 1-9, 3-4 

display of, 3-4 

login, 3-4 

special log-on formats, 1-10, 1-11 
UIC/UFD, difference between, 3-4 
User File Directory (UFD), 1-9, 3-4 
User Identification Code (UIC), 1-9, 3-4 

command formats, 1-11 

slash formats, 1-11 
User Logon Text File, 1-10 


V 


Volume, 2-1 
Volume unit number, 3-1 


WwW 


Wildcard, 4-7 
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INTRODUCTION 


This manual is a brief index to the RSX-11M documentation set. It indicates where in the set informa- 
tion on a general topic can be found. A more detailed master index is being published as a post-release 
document. Neither index, however, is intended to replace the indexes found in the individual RSX- 
11M manuals. 


An acronym printed in italic capital letters follows each entry in this index, and represents the name of 
the manual in which the information can be found. Chapter and section number references follow the 
acronym, Some entries are followed only by the chapter number(s), for example: 


PIP (Peripheral Interchange Program), UTL 4 

This entry indicates that PIP is discussed throughout chapter 4 of the utilities manual. 
Following is a list of the acronyms with the corresponding manual titles. (The RSX-11M/RSX-11S 
Documentation Directory lists the order numbers for these manuals.) 

BEG — RSX-11M Beginner’s Guide 

CDA — RSX-11M/M-PLUS Crash Dump Analyzer Reference Manual 

DEV — RSX-11M/M-PLUS Guide to Program Development 

DRV — RSX-11M/M-PLUS I/O Drivers Reference Manual 

ERL — RSX-11M/M-PLUS Error Logging Reference Manual 

EXE — RSX-11M/M-PLUS Executive Reference Manual 

GEN — RSX-11M System Generation and Management Guide 

INT — Introduction to RSX-11M 

IOP — IAS/RSX-11 I/O Operations Reference Manual 

MAC — IAS/RSX-11 MACRO-11 Reference Manual 

MCR — RSX-11M/M-PLUS MCR Operations Reference Manual 

ODT — IAS/RSX-11 ODT Reference Manual 

SLR — IAS/RSX-11 System Library Routines Reference Manual 

TKB — RSX-11M/M-PLUS Task Builder Manual 

UMD — RSX-11M/M-PLUS User Mode Diagnostics Reference Manual 

UTL — RSX-11 Utilities Manual 

WRT — RSX-11M Guide to Writing an I/O Driver 
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INDEX 


A 


Absolute addressing mode, MAC 5.10 
Accessing files, JOP 1.1, 2.5 
Account file (ACNT) entries, 
maintaining, MCR 2.3 
Account file maintenance program, see ACNT 
ACNT (account file maintenance program), 
MCR 2.3 
Addressing, 
branch instruction, 
in MACRO-11, MAC 5.14 
in supervisor mode, EXE 3.2 
locations in a task image file, UTL 19.3 
modes, 
MACRO-11, MAC 5 
absolute, MAC 5.10 
autodecrement, MAC 5.5 
autodecrement deferred, MAC 5.6 
autoincrement, MAC 5.3 
autoincrement deferred, MAC 5.4 
immediate, MAC 5.9 
index, MAC 5.7 
index deferred, MAC 5.8 
register, MAC 5.1 
register deferred, MAC 5.2 
relative, MAC 5.11 
relative deferred, MAC 5.12 
Address mapping, EXE 3.1 
Address space, 
logical, EXE 3.1 
extended, INT’ 3.3 
virtual, EXE 3.1 
Analog-to-digital converter driver, DRV 14 
ANSI magnetic tapes, JOP G 
Appending files, UTL 4.2 
Assembler, see MACRO-11 
Assembly language, see MACRO-11 
AST (Asynchronous System Trap), DRV 1.5, 
EXE 2.3, INT 3.3 
service routine, JOP 2.8 
Asterisk, 
convention in MCR, see Wildcards 
EDT prompt, UTL 2.1 
Asynchronous System Trap, see AST 
AT. (MCR indirect file processor), INT 4.1, 
MCR 5.2, 5.6 
Audit trail, 
SLP, UTL 17, 17.4 
Autodecrement addressing mode, MAC 5.5 


Autodecrement deferred addressing mode, 
MAC 5.6 

Autoincrement addressing mode, MAC 5.3 

Autoincrement deferred addressing mode, 
MAC 5.4 


B 


Back-up and Restore Utility, see BRU 
BAD (Bad Block Locator Utility), UTL 9 
Bad Block Locator Utility, see BAD 
Bad blocks, 
information on, 
with DSC, UTL 11.5 
locating, UTL 9.4 
BASIC-11, INT 5.2 
BASIC-PLUS-2, INT 5.2 
Block I/O operations, JOP 1.4 
BRU (Back-Up and Restore Utility), UTL 10 
using, 
for data transfers, UTL 10.4 
to initialize disks, UTL 10.4 
with BAD, UTL 10.4 
with FMT, UTL 10.4 
Buffers, 
EDT text, UTL 2 
BYE command, MCR 2.3, 4.5 


C 


Card reader driver, DRV 11 
Cassette driver, DRV 9 
CDA (Crash Dump Analyzer), 
analysis with, CDA 3.1, 3.2 
obtaining crash dumps with, CDA 1.2 
running, CDA 1.3 
Checkpointing, INT 3.2 
Checksum switch, UTL 17.1, 18.2 
CLI (Command Line Interpreter), 
command-line processing, [OP 6.2 
component of Queue Manager, UTL 7 
CMP (File Compare Program), UTL 16 
COBOL, INT 5.2 
Codes, 
directive, DRV B.2 
I/O status, DRV B.1 
return, DRV 1.10 
Command line, 
BAD, UTL 9.1 
BRU, UTL 10.3 
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Command line (Cont.), 


CDA, CDA 1.4 

CMP, UTL 16 

DMP, UTL 15.2 

DSC, UTL 11.4 

EDI, UTL 3.1 

EDT, UTL 2.1, 2.2 

FLX, UTL 5.1 

FMT, UTL 8.1 

format for utilities, UTL 1.1 

LBR, UTL 14.2 

MCR, 

examples of file name, MCR 3.2 
standard format for, MCR 3.2 

PAT, UTL 18.1 

PIP, UTL 4.1 

PRESRV, UTL 12.1 

PRI, UTL 6.1, 6.2 

Queue Manager, UTL 6.4, 7.3 

SLP, UTL 17.1 

TKB, TKB 1.1 

VFY, UTL 13.2 

ZAP, UTL 19.4 
Command Line Interpreter, see CLI 
Command-line processing, 


CSI—command string interpreter, JOP 6.2 


GCML—get command line, JOP 6.1 
Commands, 

for utilities, 

summary of, UTL A 

MCR, see MCR commands 
Comparing files, UTL 16 
Compiler, 

FORTRAN IV, BEG 2.2 
Console output task, see COT 
Copying files, BEG 4.2 

DOS-11, UTL 5.2 

Files-11, UTL 4.2, 5.2 

RT-11, UTL 5.2 


CORAL-66, INT 5.2 
COT (Console Output Task), GEN C 
Crash Dump Analyzer, see CDA 


Crash dumps, 
analyzing, CDA 3.1, 3.2 
obtaining, CDA 1.2 


Creating source files, BEG 2.1 
editors for, UTL 2, 3, 17.3 
Creating UFDs, UTL 4.2 
CRF (Cross-Reference Processor), UTL D 


INDEX 


D 


Data conversion routines, SLA 4, 5 
Data formats, 

TKB input, TKB A 
Data structures, 

for I/O, WRT 2.3, 2.7 

for I/O drivers, WRT 4.1 


RDB (Region Definition Block), EXE 3.5 


TKB, TKB 2.3, 4.3 


WDB, (Window Definition Block), EXE 3.5 


Data transfers, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 


DCB (Device Control Block), WRT 2.3, 4.1 


Debugging, 

on-line, ODT 1.2 

tasks, INT 5.5 

user-written I/O drivers, WRT 3.4 
DEC Standard Editor, see EDT 
DECtape, 

driver, DRV 6 

powerfail recovery for, DRV 1.11 
DECtape II driver, DRV 7 
Deleting files, BEG 4.2 

on system, UTL 4.2 

on volumes, UTL 5.2 
Despooling files, UTL 6.1, C 
Device (see also Devices), 

drive modification, ERL D 

error reports, ERL 4.2 

independence, JNT 6.3 

null, MCR 2.2 
Device Control Block, see DCB 
Device interrupt vector, 

for I/O drivers, WRT 2.3, 4.1 
Devices (see also Device), 

file-structured, JOP 1.2 

independence of, INT 6.3 

logical, MCR 2.2 

peripheral, MCR 2.2 

physical, names for, DRV 1.7 

private, INT 4.3, MCR 2.3 

pseudo, MCR 2.2 

names for, DRV 1.7 

public, INT 4.3, MCR 2.3 

RSX-11M, DRV 1.3 

unowned, MCR 2.3 

verifying, UTL 9.3 
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Diagnostics, DPB (Directive Parameter Block), DRV 1.6 


user-mode, 


and I/O drivers, WRT 4.1 


error messages, UMD 2.5 Drivers, 


for disk drive compatibility, UMD 13 
for line printers, UMD 12 
for RF11 fixed-head disks, UMD 4 
for RKO5 cartridge disk and RKO5F fixed 
disk, UMD 5 
for RK06 and RK0O7 cartridge disk, UMD 6 
for RPO2, RPRO2, RP03, UMD 7 
for RP04, RPO5, RPO6 pack disks, UMD 3 
for RSO3 or RS04 fixed-head disk, UMD 8 
for terminals, UMD 12 
for TU10 or TSO3 magnetic tape, UMD 11 
for TU16 or TU45 magnetic tape, UMD 10 
for TU56 DECtape, UMD 9 
initiation of, UMD 2.4 
multidevice testing, UMD 2.6 
Directive Parameter Block, see DPB 
Directive codes, DRV B.2 
Directives, 
event-associated, EXE 6.1 
functions of system, [NT 3.3 
identification codes for, EXE C 
informational, EXE 6.1 
intertask communications-related, EXE 6.1 
1/O-related, EXE 6.1 
macro, MAC 7 
MACRO-11, MAC 6 
MCR AT., MCR 5.2, 5.6 
memory management, EXE 3, 6.1 
parent/offspring tasking, EXE 6.1 
summary of, EXE A 
system, 
DIR$ macro, EXE 1.4 
error returns, EXE 1.3 
FORTRAN subroutines, EXE 1.5 
macro name conventions for, EXE 1.4 
processing of, EXE 1.2 
restrictions for nonprivileged tasks, 
EXE 1.7 
task states, EXE 1.6 
task execution control, EXE 6.1 
task status control, EXE 6.1 
trap-associated, EXE 6.1 
Disks, 
backing up, with BRU, UTL 10.4 
drivers for, DRV 5 
powerfail recovery for, DRV 1.11 
Disk Save and Compress Program, see DSC 
Disk Volume Formatter, see FMT 
Displaying files, BEG 4.2 
DMP (File Dump Utility), UTL 15 


Index-4 


analog-to-digital converter, DRV 14 
card reader, DRV 11 
cassette, DRV 9 
DECtape, DRV 6 
DECtape II, DRV 7 
disk, DRV 5 
graphics display, DRV 20 
industrial control subsystems, DRV 18 
I/O, 
executive services available to, 
conditional routines, WRT 5.2 
service calls, WRT 5.3 
system-state register convention, 
WRT 5.1 
function of, WRT 1.2 
loadable, WRT 1.1 
resident, WRT 1.1 
user-written, 
debugging, WRT 3.4 
inclusion of, 
data base and driver source in, 
WRT 6.2 
device description in, WRT 6.1 
special user buffers in, WRT 6.3 
loadable, WRT 3.3 
overview of, WRT 3.1 
rebuilding, WRT 3.4 
resident, WRT 3.2 
writing, 
data structures in, WRT 4.1 
INTSV$ macro and, WRT 4.2 
multicontroller drivers, WRT 4.2 
K-series peripheral support routines, DRV 22 
laboratory peripheral accelerator, DRV 21 
laboratory peripheral systems, DRV 16 


line printer, DRV 10 
magnetic tape, DRV 8 
message-oriented communication, DRV 12 
null device, DRV 19 
paper tape reader/punch, DRV 17 
PCL11 parallel communications link, 
DRV 13 


terminal, 
full-duplex, DRV 2 
half-duplex, DRV 3 
virtual, DRV 4 
unibus switch, DRV 23 


universal digital controller, DRV 15 


INDEX 


DSC (Disk Save and Compress Program), 
initiating, 
on-line, UTL 11.2 
stand-alone, UTL 11.3 
operation, 
data transfers, UTL 11.8 
terminating, 
on-line, UTL 11.2 
stand-alone, UTL 11.3 
Dumps, 
file, with DMP, UTL 15 
system crash, 
analyzing, with CDA, CDA 3.1, 3.2 
obtaining, with CDA, CDA 1.2 
task, 
post mortem, JNT 5.5, TKB 8.1 
snapshot, INT 5.5, TKB 8.2 


E 


EDI (Line Text Editor), BEG 2.1, INT 5.1, 
UTL 3 
Editing files, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 
EDT (DEC Standard Editor), UTL 2 
Editors, 
batch, 
SLP, UTL 17 
interactive, 
EDI, INT 5.1, UTL 3 
EDT, INT 5.1, UTL 2 
ERF (error logging shutdown task), ERL 3.4 
ERL (error logger task), ERL A.1 
Errlog (error logger), ERL 2.2, 3.1 
Error codes, executive, EXE B 
Error detection, 
by ODT, ODT 5.1, 5.2 


Error logging, INT 4.4 

ERF (shutdown task), ERL 3.4, 5.4 
ERL (error logger task), ERL A.1 
Errlog (error logger), 

files, ERL 2.2 

formats, ERL B 

messages, ERL 5.1 

running, ERL 3.1 
error log file, EARL 1.2 
executive features of, ERLE 2.1 
functions of, ERL 1.2 
information from, ERL 1.2 


Error Logging (Cont.), 


messages, ERL 5.1 
operating procedures, ERL 3 
options, FRL 1.2 
purposes of, ERL 1.2 
reports, 
device error, ERL 4.2 
device interrupt timeout, ERL 4.2 
formatting, ERL 1.2 
generating, ERL 1.2, 4.1 
individual, ERL 4.2 
memory parity error, ERL 4.2 
summary, ERL 4.4 
unexpected trap or interrupts, ERL 4.2 
task interaction with, ERL 2.2 
Error messages, 
BAD, UTL 9.7 
BRU processing of, UTL 10.6 
CDA, CDA A 
CMP, UTL 16.3 
DMP, UTL 15.4 
DSC, UTL 11.9 
EDI, UTL 3.6 
EDT, UTL 2.6 
error logging, ERL 5.1 
FLX, UTL 5.6 
FMT, UTL 8.5 
LBR, UTL 14.9 
MCR, BEG 1.8, MCR A 
ODT, ODT 5.1, 5.2 
PAT, UTL 18.3 
PIP, UTL 4.3 
PRESRV, UTL 12.5 
PRI and QUE, UTL 6.6 
Queue Manager, UTL 7.4 
SLP, UTL 17.5 
TKB, TKB F 
TKTN, MCR A 
UMD, UMD 2.5 
ZAP, UTL 19.7 
Error reports, see Error logging, reports 
Event flags, EXE 2.2, INT 3.3 
in I/O operations, JOP 2.8 
Events, 
significant, DRV 1.5, EXE 1.2, INT 3.3 
Executive, 
control, INT 3.2 
error codes, EXE B 
features for error logging, ERL 2.1 
services and I/O drivers, WRT 2.4, 6 
Executive Debugging Tool, see XDT 
Executive directives, see Directives 
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F 


FCS, INT 6.3, IOP 1 
library system generation options, JOP K 
resident library, 
building 4K, GEN G 
spooling from user-written tasks with, 
UTL 6.5 
FDB (File Descriptor Block), JOP 1.9, 2.2, A 
offsets, JOP 2.3 
File access, 
methods of, JOP 1.1 
optimizing, JOP 2.5 
File control routines, 
ASCII-to-binary UIC conversion, JOP 4.6 
default directory-string, JOP 4.2 
default file-protection word, JOP 4.4 
default UIC, JOP 4.3 
device control, JOP 4.16 
directory entry, JOP 4.8 
file deletion, JOP 4.15 
file extension, JOP 4.13 
filename block, JOP 4.7, 4.9 
file owner word, JOP 4.5 
file pointer, JOP 4.10 
file truncation, JOP 4.14 
queue 1/0 function, JOP 4.11 
rename file, JOP 4.12 


File Control Services, see FCS 
File Descriptor Block, see FDB 
File despooling, UTL 6.1, C 
File directory, see UFD 
File dumping, UTL 15 
File Dump Utility, see DMP 
File-header block format, JOP F 
File labels, DSC, UTL 11.5 
File manipulation, INT 6.2 
Filename block, JOP B 
File ownership, INT 6.2, MCR 3.1 
File protection, INT 6.2 
access type, MCR 3.1 
assigning access rights, MCR 3.1 
user groups, MCR 3.1 
with PIP, UTL 4.2 
Files, 
copying, BEG 4.2, UTL 4.2 
creating, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 
correction, 
PAT, UTL 18.2 


Files (Cont.), 
deleting, BEG 4.2 
despooling, UTL 6.1, 6.4, 7,C 
device name, BEG 3.1 
displaying, BEG 4.2 
editing, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 
indirect command, 
MCR, MCR 5 
library, UTL 14.5 
listing, in queue, BEG 4.3 
manipulating, INT 6.2 
merging, UTL 4.2 
printing, BEG 4.3, UTL 4.2, 6, 7 
purging, BEG 4.2, UTL 4.2 
renaming, BEG 4.2, UTL 4.2 
spooling, UTL 4.2, 6.1, 6.2, 7,C 
task image, structure of, TKB B 
UFDs for, BEG 3.2 
validating (verifying) contents of, 
with PAT, UTL 18.2 
with SLP, UTL 17.1, 17.5 
Files-11, 
copying, files with PIP, UTL 4.2 
directories (UFDs) for files, INT 6.2, 
MCR 3.1 
ownership of files, INT 6.2, MCR 3.1 
protection for files, INT 6.2, MCR 3.1, 
UTL 4.2 . 
access types, MCR 3.1 
assigning access rights, MCR 3.1 
user groups, MCR 3.1 
File specifications, INT 6.2 
creating, within user program, JOP 2.4 
dataset descriptor in, JOP 2.4 
default filename block in, JOP 2.4 
dynamic processing of, JOP 2.4 
for utilities, 
defaults for, UTL 1.1 
format of, UTL 1.1 
MCR, MCR 3.2 
TKB, TKB 1.7 
File specifiers, 
MCR, MCR 3.2 
File spooling, UTL 6.1, 6.2, 7 
File Storage Region, see FSR 


File-structured devices, 
data formats for, JOP 1.2 


File structures, 
disk and DECtape (Files-11), JOP 5.1 
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File structures (Cont.), 


in magnetic tape file processing, JOP 5.2 


verifying, with VFY, UTL 13 


File Structure Verification Utility, see VFY 


File system, 
Files-11, see Files-11 
RSX-11M, INT 6.1 
File Transfer Program, see FLX 
File transfers, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 
File types, 
MCR standard, MCR 3.2 
FLX (File Transfer Program), UTL 5 
file transfers, 
command line for, UTL 5.1 
volumes, 
transferring files between, UTL 5.2 


FMT (Disk Volume Formatter), UTL 8 
Fork list, 
and I/O drivers, WRT 2.3 
Format, 
file header block, JOP F 
index file, JOP E 
QIO macro format, DRV 1.5 
TKB input data, TKB A 
Formats, 
CMP output file, UTL 16.2 
data, 
for file-structured devices, JOP 1.2 
Formatting, 
output, routines for, SLR 6 
volumes, 
with FLX, UTL 5 
with FMT, UTL 8 
FORTRAN IV, INT 5.2 
compiling, source file, BEG 2.2 


INDEX 


H 


HELLO command, BEG 1.2, MCR 2.3, 4.5 
HELP command, BEG 1.2, MCR 4.5 


I 


Immediate addressing mode, MAC 5.9 
Index addressing mode, MAC 5.7 
Index deferred addressing mode, MAC 5.8 
Index file, 
format, JOP E 
bit map in, JOP E.3 
bootstrap block in, JOP E.1 
home block in, JOP E.2 
predefined file header blocks in, JOP E.4 
Indirect command files, 
MCR, INT 4.1, MCR 5.1 
AT. (indirect file processor), MCR 5.2 
default file type for, MCR 5.1 
example of, MCR 5.8 
initiating, MCR 5.1 
multilevel, MCR 5.5 
switches, MCR 5.4 
symbols, MCR 5.3 
task, MCR 5.1, TKB 1.5 
with utilities, UTL 1.4 
Industrical control subsystems drivers, 
DRV 18 
Initializing volumes, 
with FLX, UTL 5.2 
Install-run-remove tasks, MCR 4.2 
Interrupts, 
report on unexpected, ERL 4.2 
Invoking, 
RSX-11 utilities, UTL 1.1 
I/O, 
logical, DRV 1.2 
physical, DRV 1.2 
RSX-11M, DRV 1.1 


requesting a nonresident compiler, BEG 2.2 virtual, DRV 1.2 


sample program, BEG A 
FORTRAN IV-PLUS, INT 5.2 
FSR (File Storage Region), JOP 1.1 

initializing, JOP 2.6 

size of, JOP 2.7 


I/O completion, DRV 1.9 

I/O data structures, WRT 2.3 
interrelationships, WRT 2.7 

I/O drivers, see Drivers 

I/O executive services, WRT 2.4 

I/O exerciser, see IOX 


G I/O function codes, DRV B.3 
I/O functions, 
Generating an RSX-11M system, see System standard, DRV 1.8 


generation 
Global symbols, TKB 2.1, 4.2 
Graphics display driver, DRV 20 


summary of, DRV A 
I/O operations, 
block, JOP 1.4 
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I/O operations (Cont.), 
coordinating, JOP 2.8 
AST service routine, JOP 2.8 
event flags, JOP 2.8 
I/O status block, JOP 2.8 
physical, INT 6.4 
record, JOP 1.5 
task, INT 6.3 
I/O packet, 
and I/O drivers, WRT 2.8, 4.1 
I/O philosophy, WRT 2.1 
I/O programming standards, WRT 2.5 
I/O queue, 
and I/O drivers, WRT 2.3 
I/O request, 
flow of, WRT 2.6 
issuing, DRV 1.5 
I/O status codes, DRV B.1 
I/O structure, WRT 2.2 
IOX (I/O exerciser), GEN E 


K 


K-series peripheral support routines drivers, 
DRV 22 


L 


Laboratory peripheral accelerator driver, 
DRV 21 
Laboratory peripheral systems driver, DRV 16 
Languages, 
BASIC-11, INT 5.2 
BASIC-PLUS-2, INT 5.2 
COBOL, INT 5.2 
CORAL-66, INT 5.2 
FORTRAN IV, INT 5.2 
FORTRAN IV-PLUS, INT 5.2 
supported, INT 2.2 
LBR (Librarian Utility Program), UTL 14 
Library, 
files, 
format of, UTL 14.5 


system, routines, see System library rou- 


tines 

Line printer driver, DRV 10 
Line Text Editor, see EDI 
Listing files, 

creating, BEG 2.2 

in queue, BEG 4.3 

with FLX, UTL 5.2 

with PIP, UTL 4.2 


Locations, manipulating, 
in a task image file, UTL 19.5, 19.6 
Logging off a terminal, MCR 2.3 
Logging on a terminal, MCR 2.3 
Logical address space, EXE 3.1 
extended, INT 3.3 
Logical I/O, DRV 1.2 
Logical unit number, see LUN 
Logical units, DRV 1.4 
LPP (Despool Prototype Task), 
as component of Queue Manager, UTL 7 
LUN (Logical Unit Number), DRV 1.4, 1.7 


M 


Macro 
QIO, format, DRV 1.5 
MACRO-11, INT 5.2 

addressing, 
branch instruction, MAC 5.14 

addressing modes, 
absolute, MAC 5.10 
autodecrement, MAC 5.5 
autodecrement deferred, MAC 5.6 
autoincrement, MAC 5.3 
autoincrement deferred, MAC 5.4 
immediate, MAC 5.9 
index, MAC 5.7 
index deferred, MAC 5.8 
register, MAC 5.1 
register deferred, MAC 5.2 
relative, MAC 5.11 
relative deferred, MAC 5.12 
summary of, MAC 5.13 

assembly and cross-reference listing, 
sample of, MAC I 

character set, MAC 3.1 

coding standard, 
sample of, MAC E 

command line format, MAC 8.1 

direct assignment statements for, MAC 3.3 

directives, 
conditional assembly, MAC 6.10 
data storage, MAC 6.3 
function, MAC 6.2 
listing control, MAC 6.1 
location counter control, MAC 6.5 
macro, MAC 7 
program boundaries, MAC 6.7 
program sectioning, MAC 6.8 
summary of, MAC B 
symbol control, MAC 6.9 
terminating, MAC 6.6 
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MACRO-11 (Cont.), 
error messages, MAC 8.4 
summary of diagnostic, MAC D 
expressions, MAC 3.9 
file specification format, MAC 8.3 
file specification switches, MAC 8.1 
numbers, MAC 3.7 
operating procedures, MAC 8 
overview of, MAC 1.1 
Permanent Symbol Table (PST), MAC C 
position-independent code, 
writing, MAC G 
radix and numeric control facilities, MAC 6.4 
relocation and linking, MAC 4 
source programs, MAC 2.2, 2.3 
programming standards and conventions 
for, MAC 2.1 
symbols, MAC 3.2 
local, MAC 3.5 
register, MAC 3.4 
terms, MAC 3.8 
trap instructions, MAC 5.15 
virtual memory, 
allocating, MAC F 
Macro calls, 
file-processing, JOP 3.1-18 
Macros, 
arguments for, MAC 7.3 
calling, MAC 7.2 
defining, MAC 7.1 
1/O-related, DRV 1.7 
Magnetic tapes, 
ANSI standard, JOP G 
driver for, DRV 8 
Maintenance, 
system, features of, INT 4.4 
Mapped systems, INT 3.1 
task relocation on, TKB 2.4 
TKB addressing on, TKB 2.2 
Mapping, 
addresses, EXE 3.1 
MCR, 
command line, MCR 3.2 
commands, BEG 1.2 
description of format and syntax, MCR 4.4 
format for, MCR 4.1 
issuing, MCR 4.1 
line terminators for, MCR 4.1 
nonprivileged, MCR 4.5 
parameters for, MCR 4.1 
privileged, MCR 4.6 
summary of, MCR 4.3 
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MCR interface, INT 4.1, MCR 4.2 
command references to active tasks, 
MCR 4.2 
comments, MCR 4.2 
keywords, MCR 4.2 
Memory, 
organization of, INT 3.1 
parity error reports, ERL 4.2 
Memory dumps, TKB 8.1, 8.2 
Memory management, 
directives, EXE 3, 6.1 
dynamic, routines, SLA 7 
virtual, routines, SLR 8 
Merging files, UTL 4.2 
Message-oriented communication driver, 
DRV 12 
Messages, see Error Messages 
Mode, 
supervisor, 
addressing in, EXE 3.2 
Modes, 
for reading logical records, JOP 3.9, 3.10, 
3.11 
for writing logical records, JOP 3.12, 3.13, 
3.14 
MACRO-11 addressing, MAC 5 
Monitor Console Routine, see MCR 
Multicontroller I/O drivers, WRT 4.2 
Multiprogramming, MCR 1.3 
applications, MCR 3 


N 
Networks, INT 2.3 
Null device, MCR 2.2 
driver, DRV 19 
O 


Object Module Patch Utility, see PAT 
Object modules, 
creating, BEG 2.2 
linking with TKB, TKB 2.1 
updating, with PAT, UTL 18.2 
ODT (On-Line Debugging Tool), 
linking and initiating, ODT 4.3 
relationship to ZAP, UTL 19 
Offsets, 
FDB, JOP 2.3 
On-Line Debugging Tool, see ODT 
Operating procedures, 
error logging, ERL 3 


INDEX 


Operating procedures (Cont.), 
MACRO-11, MAC 8 
ODT, ODT 4 
Operators, 
SLP, UTL 17.3 
ZAP arithmetic, UTL 19.4 
Output, 
formatting routines, SLR 6 
Overlay, TKB, 
building an, TKB 4.7 
data structures, TKB 4.3 
descriptor language, TKB 4.4 
summary of, TKB 4.5 
error handling, TKB 5.3 
loading methods, TKB 5.1, 5.2 
programs, TKB 4.6 
structures, 7KB 4.1 
tree, TKB 4.2, 4.5 


P 


Paper tape reader/punch driver, DRV 17 
Parent/offspring tasking, EXE 4.1, 4.2 
Parity error reports, ERL 4.2 
Parsing a UFD command line, 
example of, JOP 7.6 
Partitions, MCR 1.2 
PAT (Object Module Patch Utility), UTL 18 
Task Builder and, 
adding a subroutine to a module with, 
UTL 18.2 
overlaying lines in module with, UTL 18.2 
updating (patching) object modules with, 
UTL 18.2 
Patching, 
object modules (relocatable), with PAT, 
UTL 18.2 
task image files, with ZAP, UTL 19.5 
PCL11 parallel communications link driver, 
DRV 138 
Peripheral Interchange Program, see PIP 
Permanent Symbol Table, see PST 
Physical I/O, DRV 1.2 
operations, INT 6.4 
PIP (Peripheral Interchange Program), BEG 
4.1, INT 6.2, UTL 4 
command functions, UTL 4.2 
copying Files-11 files with, UTL 4.2 
Position-independent code, 
writing, MAC G 
Post mortem dumps, /NT 5.5, TKB 8.1 
-Powerfail recovery, 
for DECtape and disks, DRV 1.11 


Power failure restart, INT 4.4 
Preservation Utility, see PRESRV 
PRESRV (Preservation Utility), UTL 12 
operating procedures, UTL 12.2 
PRI and QUE (Print and Queue Manager), 
despooling files with, UTL 6.1 
Print command, UTL 6.1-3 
format, UTL 6.2 
Queue Manager, 
command format, UTL 6.4 
commands, 
nonprivileged user, UTL 6.4 
privileged user, UTL 7.3 
serial despooler with, UTL 6.1 
spooling, 
files with, UTL 6.1 
output from user-written tasks with, 
UTL 6.5 
PRINT command, 
format, UTL 6.2 
description of, UTL 6.3 
spooling output from user-written tasks 
with, UTL 6.5 
Printing files, BEG 4.3 
Print jobs, UTL 6.1 
attributes of, UTL 6.1 
identification, UTL 6.4 
queued by user tasks, UTL 6.5 
queue entries for, UTL 7 
Processor Status Word, see PSW 
Program development, [NT 2.2 
cross-reference listing in, 
generating, DEV 3.5, 4.3 
debugging in, INT 5.5, DEV 5 
dumps in, INT 5.5, DEV 5.2, 5.3 
editing utilities for, INT 5.1 
environment, DEV 1 
DIGITAL-supplied system software, 
DEV 1.2 
hardware, DEV 1.3 
software tools, DEV 1.1 
errors, 
assembly, DEV 3.1 
task building, DEV 4.4 


Fortran IV, procedures, DEV 7 


languages for, INT 5.2 
supported, INT 2.2 


process, DEV 1.4 


program libraries in, 
macro source, DEV 6.1 
object module, DEV 6.2 


program modules in, DEV 3 
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Program development (Cont.), 
source files in, 
creating from a skeleton file, DEV 2.2 
diagnostics, performing, DEV 3.1 
editing, DEV 2.3 
MACRO-11, creating, DEV 2 
task building in, JNT 5.38, DEV 4, TKB 3.1 
Programming languages, see Languages 
Program sections, TKB 2.1, 4.2 
virtual, TKB 3.4 
Prompts, 
MCR input, MCR 2.1 
Protecting files, see File protection 
PSE (error logging pre-formatter), ERL 
232, Oe 
PSW (Processor Status Word), ODT A 
Purging files, BEG 4.2, UTL 4.2 


Q 


QIO macro format, DRV 1.5 
Queue Manager, BEG 4.3, INT 6.2 
RSX-11M V3.2, UTL 6, 7, GEN D 
command format, UT'L 6.3, 7.4 
commands, 
nonprivileged, UTL 6.4 
privileged, UTL 7.3 
components of, UTL 7 
installing, UTL 7.1 
reference example, UTL 7.2 


R 


RDB (Region Definition Block), EXE 3.5 
Record I/O operations, JOP 1.5 
Record Management Services, see RMS 
Region Definition Block, see RDB 
Regions, EXE 3.3 

dynamic, in TKB, TKB 3.3 

shared, in TKB, TKB 3.1 

Register addressing mode, MAC 5.1 
Register deferred addressing mode, MAC 5.2 
Register handling routines, SLR 2 
Reject transitions, 

example of using, JOP 7.6 
Relative addressing mode, MAC 5.11 
Relative deferred addressing mode, MAC 5.2 
Renaming files, BEG 4.2 

with PIP, UTL 4.2 
Reports, error logging, see Error logging, 

reports . 

Restarting system, 

after power failure, INT 4.4 


Return codes, DRV 1.10 
RM Demo, GEN B 
RMS (Record Management Services), INT 6.3 
Round robin scheduling, INT 3.2 
Routines, 
file control, see File control routines 
system library, see System library routines 
RSX-11M, 
applications of, 
multiprogramming, INT 3 
real-time, INT 2.1, 3 
devices, DRV 1.3 
file system, INT 6.1 
introduction to, INT 1.1 
system generation, see System generation 
RSX-11S, 
introduction to, INT 1.2 


S 


SCB (Status Control Block), 
and I/O drivers, WRT 2.3, 4.1 
Serial Despooler Task, UTL 6.1, C 
Shared Peripheral Operations On-Line, see 
Spool 
Shutting down system, MCR 2.4 
SHUTUP program, MCR 2.4 
Significant events, DRV 1.5, EXE 2.1, INT 3.2 
SLP (Source Language Input Program), 
UTL 17 
editing source files with, UTL 17.3 
processing, UTL 17.2 
Snapshot dumps, INT 5.5, TKB 8.2 
Source files, 
creating with SLP, UTL 17.3 
updating with SLP, UTL 17.3 
Source Language Input Program, see SLP 
Spool (Shared Peripherals Operation On-Line), 
UTL 6.1 
Spooling, 
from user-written tasks, UTL 6.5 
with PIP, UTL 4.2 
with PRI and QUE, UTL 6.1 
with PRINT$ macro call, JOP 7.6 
SST (Synchronous System Trap), DRV 1.5, 
EXE 2.3, INT 3.3 
Status Control Block, see SCB 
Stop-bit synchronization, EXE 2.4 
Subexpressions, 
example of using, JOP 7.6 
Subpartitions, INT 3.1, MCR 1.2 
Supervisor mode, 
addressing in, EXE 3.2 
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Swapping, INT 3.2 
Switches, 
BAD, UTL 9.2, 9.5 
CDA, CDA 2.1, 2.2 
CMP, UTL 16.1 
DMP, UTL 15.3 
DSC, UTL 11.5, 11.7 
FLX, UTL 5.2 
FMT, UTL 8.4 
for utilities, summary of, UTL A 
LBR, UTL 14.4, 14.6 
MCR, MCR 5.4 
ODT, ODT 4.2 
PAT, UTL 18.1 
PIP, UTL 4.1, 4.2 
PRESRV, UTL 12.3 
Print command, UTL 6.3 
Queue Manager, UTL 6.3 
SLP, UTL 17.4 
TKB, TKB 6.1 
modifying defaults for, TKB D.2 
ZAP, UTL 19.2 
SYE (error logging report generator), ERL 3.3 
Symbol definition file, TAB 3.1 
Symbols, 
global, TKB 2.1, 4.2 
indirect command file, MCR 5.3 
reserved, TKB C 
substituting values for, INT 4.1 
Synchronous System Trap, see SST 
System, 
host, for TKB, TKB 7 
restarting, after power failure, JNT 4.4 
shutting down, MCR 2.4 
target, for TKB, TKB 7 
System conventions, GEN F 
System directives, see Directives, system 
System generation, RSX-11M V3.2 
getting started, GEN 5 
installation verification, GEN 10 
system conventions, GEN F 
VMR, GEN 8 
System library routines, 
arithmetic routines, SLR 3.1, 3.2 
dynamic memory management routines, 
SLR 7.1-4 
input data conversion routines, SLA 4.1-3 
output data conversion routines, SLR 5.1-4 
output formatting routines, SLR 6.1-3 
register handling routines, SLR 2.1-4 
virtual memory management routines, 
SLR 8.1-5 


System maintenance, 
features of, INT 4.4 
System traps, INT 3.3 
asynchronous (ASTs), DRV 1.5, EXE 2.3, 
INT 3.8 
synchronous (SSTs), DRV 1.5, EXE 2.3, 
INT 3.3 


T 


Table-driven parser, see TPARS 
Tape devices, 
multivolume operations with BRU, 
UTL 10.5 
Tapes, 
DECtape, see DECtape 
magnetic, see Magnetic tapes 
Task, 
interaction with error logging, ERL 2.2 
I/O operation, INT 6.3 
Task Builder, see also TKB 
use of, with PAT, UTL 18.2 
Task dumps, 
post mortem, INT 5.5, TKB 8.1 
snapshot, INT 5.5, TKB 8.2 
Task image, 
building, BEG 2.3 
file, structure of, TKB B 
memory allocation (map) file, BEG 2.3 
options, BEG 2.3 
running a, BEG 2.4 
switches, BEG 2.3 
Task/Image File Patch Program, see ZAP 
Task names, 
convention for, MCR 4.2 
references to in MCR, MCR 5.7 
Tasks, MCR 1.1 
building, INT 5.3, TKB 3.1 
checkpointing, INT 3.2 
creating, MCR 1.4 
debugging, INT 5.5 
executing, INT 5.4, MCR 1.4 
external scheduling for, INT 4.1 
installing, MCR 1.4 
install-run-remove, MCR 4.2 
linking, TKB 3.1 
MCR command interface and, MCR 4.2 
multiuser, TKB 3.2 
naming convention for, MCR 4.2 
priority of, INT 3.2 
privileged, EXE 3.6, TKB 3.5 
scheduling, 
external, INT 4.1 
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Tasks, scheduling (Cont.), 
round robin, INT 3.2 
swapping, INT 3.2 
state of, INT 3.2 
user-written, spooling from, UTL 6.5 
Terminals, 
attached, INT 4.2, MCR 2.1 
characteristics of, MCR 2.1 
control characters on, BEG 1.1, MCR 2.1 
drivers for, 
full-duplex, DRV 2 
half-duplex, DRV 3 
virtual, DRV 4 
function keys on, BEG 1.1 
input prompts for, MCR 2.1 
keyboard on, BEG 1.1 
logging off, MCR 2.3 
logging on, MCR 2.3 
privilege for, MCR 2.1 
slave, INT 4.2, MCR 2.1 
special character keys on, MCR 2.1 
unattached, MCR 2.1 


TKB, see also Task Builder, 
assigning addresses, 
on mapped systems, T7KB 2.2 
on unmapped systems, TKB 2.2 
building and linking with, TKB 3.1 
command line, TKB 1.1 
data structures, 
building system, TKB 2.3 
overlay, TKB 4.3 
fast, TKB E 
functions, TKB 2 
global symbols, 
resolving, TKB 2.1, 4.2 
host system for, TKB 7 
improving performance of, TKB D 
memory dumps, 
post mortem, TKB 8.1 
snapshot, TKB 8.2 
program sections, 
allocation of, TKB 2.1, 4.2 
virtual, TKB 3.4 
object modules, 
linking, TKB 2.1 
overlay, 
building an, TKB 4.7 
data structures, TKB 4.3 
descriptor language, TKB 4.4 
summary of, TKB 4.8 
error handling, TKB 5.3 
loading methods, TKB 5.1, 5.2 


INDEX 


TKB, overlay (Cont.), 
programs, TKB 4.6 
structures, TKB 4.1 
tree, TKB 4.2 
multiple-tree structures, TKB 4.5 
reserved symbols, TKB C 
slow, TKB D.3 
symbol definition file, TKB 3.1 
target system for, TKB 7 
task image file structure, TKB B 
task relocation, TKB 2.4 
tasks, 
multiuser, TKB 3.2 
privileged, TKB 3.5 
TPARS 
parser program using, 
how to generate, JOP 7.5 
source programs and, JOP 7.1 
Transferring files, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 
Traps, 
reports on unexpected, ERL 4.2 
systems, INT 3.3 
asynchronous (ASTs), DRV 1.5, EXE 2.3 
synchronous (SSTs), DRV 1.5, EXE 2.3 


U 


UCB (Unit Control Block), 
and I/O drivers, WRT 2.3, 4.1 
UFD (User File Directory), BEG 3.2 
creating, with PIP, UTL 4.2 
in Files-11 file system, INT 6.2, MCR 3.1 
UIC (User Identification Code), MCR 3.2 
UMD (User-Mode Diagnostics), see Diagnos- 
tics, user mode 
Unibus switch driver, DRV 23 
Unit Control Block, see UCB 
Universal digital controller driver, DRV 15 
Unmapped systems, INT 3.1 
User File Directory, see UFD 
User Identification Code, see UIC 
User-Mode Diagnostics, see Diagnostics, 
user-mode 
User written drivers, see Drivers, I/O, 
user-written 
Utilities, 
command line format for, UTL 1.1 
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Utilities (Cont.), 
editing, 
EDI, UTL 3 
EDT, UTL 2 
file manipulation, 
FLX, UTL 5 
PIP, UTL 4 
file specification format for, UTL 1.1 
file spooling, 
PRI and QUE, UTL 6 
Queue Manager, UTL 7 
indirect command files and, UTL 1.4 
invoking, UTL 1.4 
list of, UTL 1.1 
program maintenance, 
CMP, UTL 16 
PAT, UTL 18 
SLP, UTL 17 
ZAP, UTL 19 
programming, 
DMP, UTL 15 
LBR, UTL 14 
volume maintenance, 
BAD, UTL 9 
BRU, UTL 10 
DSC, UTL 11 
FMT, UTL 8 
PRESRV, UTL 12 
VFY, UTL 13 


Vv 


Verifying, 
contents of a task image file with ZAP, 
UTL 19.6 
file structures with VFY, UTL 13 
VFY (File Structure Verification Utility), 
UTL 18 
Virtual address space, EXE 3.1 


Virtual I/O, DRV 1.2 
Virtual Monitor Console Routine, see VMR 
VMR (Virtual Monitor Console Routine), 
GEN 8 
Volumes, 
backing up, with BRU, UTL 10.4 
deleting files from, with FLX, UTL 5.2 
directory listings of, with FLX, UTL 5.2 
formatting, 
with FLX, UTL 5.2 
with FMT, UTL 8.3 
initializing, with FLX, UTL 5.2 
preserving, with PRESRV, UTL 12 
transferring files between, with FLX, 
UTL 5.2 


W 


WDB (Window Definition Block), 
data structure, EXE 3.5 
Wildcards (asterisk), 
convention as file specifier, MCR 3.2 
in PIP file specifications, UTL 4.1 
Window Definition Block, see WDB 


X 


XDT (Executive Debugging Tool), 
and I/O drivers, WRT 3.4 


Z 


ZAP (Task/Image File Patch Program), 
UTL 19 
addressing locations in a task image with, 
UTL 19.3 
changing contents of a location with, 
UTL 19.5 


Index-14 


RSX-11M 

Mini-Index 

AA-H262A-TC 
READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 


— 
——— 
— 
—— 
— 
— 
 eeemaeand 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


[1 Assembly language programmer 
(1  Higher-level language programmer 
O Occasional programmer (experienced) 
C} User with little programming experience 
CL) Student programmer 
O = Other (please specify) 
Name Date 
Organization _ 
Street 
a eS Fp Code 


or 
Country 
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